GeoXMind

OGC API Records 用目录记录发现地理资源

说明记录、目录、集合和链接怎样描述可发现资源，并分析空间时间查询、可爬取目录和资源访问边界。

OGC API Records 用目录记录发现地理资源

地理数据、服务、样式、处理过程和模型分散在不同系统中，用户往往先需要知道资源是否存在、覆盖哪里、何时有效以及怎样访问。OGC API Records 用标准化记录和目录暴露这些描述信息，使人和程序可以浏览或搜索资源。

Record 是关于资源的元数据，不是资源本身。搜索命中一个影像记录，不表示影像文件公开可读、质量合格或仍然在线，客户端必须继续沿链接检查。

入口与符合性支持能力发现

客户端从 landing page 进入，通过链接找到 API 描述、符合性声明和目录集合。符合性类说明实现支持哪些标准模块，客户端不应根据产品名称猜测查询能力。

API 描述可供开发者和工具理解路径与参数，但业务语义仍来自记录模型和集合说明。一个 OpenAPI 文件语法正确，不代表元数据内容完整。

链接关系是导航基础。客户端跟随 relation 和 media type，比拼接固定路径更能适应不同部署地址和表示格式。

Catalog collection 组织记录集合

标准把记录组织为 catalog，可通过 collections 资源发现。一个服务可以有多个目录，例如按机构、主题或安全域分开。目录描述包含范围、标识和可用链接。

划分目录应服务治理和查询，不应复制同一记录形成难以同步的多个真相。跨目录引用可以使用稳定链接，权威记录位置需明确。

集合范围要随成员维护。空间或时间范围过宽会产生无关候选，过窄又让搜索漏掉记录。自动摘要也要处理删除和访问权限变化。

Record 提供资源评估所需摘要

记录可以描述数据集、服务、地图、瓦片、样式、处理过程、地球观测资产或其他资源。常见信息包括标识、标题、描述、空间时间范围、主题、许可和分发链接。

记录 ID 在目录中应稳定。资源文件迁移或访问地址变化时，记录身份可以保留并更新链接；若内容语义发生根本变化，应考虑新版本或新记录。

摘要不能代替完整质量报告。分辨率、精度、处理级别和已知限制应通过明确字段或关联文档提供，避免营销式描述影响选择。

搜索由空间、时间和属性谓词缩小记录

Records API 可以在目录 items 端点按边界框、时间和其他参数查询。空间条件匹配记录范围，不表示资源每个位置都有有效数据；时间相交也不表示在整个区间连续观测。

分页必须沿响应中的链接继续。服务可以限制页大小，客户端不能假设一次返回所有结果，也不应在翻页期间忽略目录更新导致的重复或遗漏。

更丰富过滤能力属于相应扩展或实现能力。客户端应检查符合性声明，无法支持时给出降级，而不是发送私有参数后默默得到不同结果。

可爬取目录与可搜索 API 服务不同规模

静态或可爬取目录可把记录作为 Web 文件发布，通过链接逐个发现，部署简单、适合对象存储和搜索引擎抓取。大规模组合查询则更适合带索引的 API。

可爬取不等于所有页面都能被公共搜索引擎理解。HTTP 状态、稳定 URL、HTML 表示、链接可达性和 robots 策略仍然重要。机器 JSON 与人类页面可以通过内容协商并存。

静态目录更新需要原子发布，避免根目录已链接新记录而文件尚未上传。版本目录和清单校验可以减少半完成状态。

链接把元数据连接到访问与处理

记录可链接到实际数据、服务端点、缩略图、许可和文档。链接应声明 relation、media type 和必要标题，让客户端知道是下载、API、预览还是说明。

受限资源可以公开元数据但要求认证访问。记录不能包含长期密钥或签名 URL，短期授权应在访问时生成。权限撤销后，目录缓存和搜索索引也要更新。

链接健康检查要区分暂时不可达和永久失效。盲目删除短时故障资源会破坏目录稳定，长期 404 又会降低可信度。

与 STAC 的交集不等于完全互换

STAC 重点组织时空资产，Item、Collection 和 Asset 对地球观测数据尤其直接。OGC API Records 面向更广的可发现资源，包括服务、样式和处理过程。

两者都使用 Web 链接、GeoJSON 相关表示和集合查询，可建立兼容映射。但扩展字段、资产角色和记录语义仍需逐项确认，不能只改顶层类型名称。

系统可以让 STAC 资产进入 Records 总目录，或提供同一后端的不同接口。需要指定权威字段和同步方向，避免两套元数据各自更新。

目录质量决定发现结果是否可信

质量检查包括 schema、唯一 ID、空间范围、时间格式、许可、链接和更新日期。还应抽样对照真实资源，确认范围、格式和访问条件没有过期。

重复记录需要来源和版本规则。仅按标题去重会误合并不同版本，按 URL 去重又会漏掉镜像。稳定资源标识和谱系比模糊文本匹配更可靠。

运行监控应观察索引延迟、空结果率、失效链接和热门查询。用户找不到已知资源时，问题可能在元数据、索引、权限或查询界面，应保留诊断链。

OGC API Records 为资源发现建立通用 Web 契约。它解决“怎样描述并找到”，不替代数据访问、质量验证和授权。把记录、资源和链接生命周期分开管理，目录才能成为长期可信入口。

资料依据