OGC API-环境数据检索简介¶

引言¶

OGC API-环境数据检索是一个标准，它提供了一系列轻量级接口来访问环境数据资源。该标准也称为环境数据检索(EDR)API，解决了两个基本操作：发现和查询。发现操作允许询问API以确定其功能并检索有关此资源分布的信息(元数据)。这包括服务器的API定义以及关于服务器提供的环境数据资源的元数据。查询操作允许根据本标准定义并由客户端选择的简单选择标准，从底层数据存储中检索环境数据资源。

备注

本教程模块并不是要取代实际的 OGC API - Environmental Data Retrieval 标准的。本教程有意将重点放在功能的子集上，以便让学生开始使用该标准。请参阅 OGC API - Environmental Data Retrieval 附加细节的标准。

背景¶

历史

版本1.0.0发布于2021-08-13。

版本

OGC API - Environmental Data Retrieval 版本1.0.0是当前的最新版本

测试套件

草案可执行测试套件可用于：

OGC API - Environmental Data Retrieval

实施方案

实现可在此处<http://www.opengeospatial.org/resource/products/byspec>的OGC产品数据库中找到

用法¶

OGC API - Environmental Data Retrieval 提供一系列轻量级查询接口，通过在某个位置、区域内、沿轨迹或通过走廊请求数据来访问时空数据资源。时空数据资源是可以使用EDR查询模式几何对其进行采样的时空数据的集合。

该标准提供了一个标准接口，用于请求由地理要素及其属性组成的矢量地理空间数据。这样做的好处是，客户端应用程序可以从API的多个实现请求源数据，然后呈现数据以供显示或作为工作流的一部分进一步处理数据。该标准使数据能够与其他数据一致地访问。还可以一致地访问使用常见数据类型(如文本字符串、日期和时间)编码的特征属性。

与其他OGC标准的关系¶

OGCAPI-特性：EDRAPI与OGCAPI - Feature - Part 1：Core(OGC17-069r3)完全兼容，因为它支持集合和项。它通过允许“实例”(一种形式的“集合”)来扩展集合功能。EDR API还支持按命名位置和坐标检索时空数据。
移动特征：移动特征标准关注沿轨迹移动的物体，并通过刚体旋转同时改变其方向。EDR API没有定向、分层或棱柱的概念。移动特征和EDR API确实共享来自ISO的共同轨迹概念定义，但是移动特征标准以GML、CSV和移动特征JSON编码轨迹，而EDR API以WKT编码轨迹。
Web Coverage Service(WCS)和Coverage Implementation Schema(CIS)：EDR API的主要消息传递机制是基于HTTP(S)的JSON，包括CoverageJSON。EDR API的实现使用OpenAPIV3.0规范进行描述。EDR API与WCS和CIS标准一致，但不要求最终用户或开发人员使用术语Domain和RangeSet。如果数据坐标参考系是一致的，EDR API还可以用于针对Coverage集合生成单个查询。
OGC SensorThings API：SensorThings API遵循OData的请求实体规范。相反，EDR API使用OpenAPIV3.0规范来描述资源路径、查询选项、JSON模式和其他方面。此外，EDR API允许检索覆盖率数据和HTML响应-SensorThings API不支持这两者。
传感器观测服务(SOS)：EDR API允许检索覆盖数据和HTML响应-SOS标准不支持这两者。此外，SOS实现使用GetCapability操作来提供可用资源的描述。相反，EDR API使用OpenAPI定义文档来描述可用接口。

资源概述¶

OGC API - Environmental Data Retrieval Standard 定义下表中列出的资源。

OGC API概述-功能资源¶
资源	路径	目的
登录页	{root}/	这是顶级资源，用作入口点。
一致性声明	{root}/一致性	此资源提供有关服务器实现的功能的信息。
接口定义	{root}/接口	此资源提供有关API本身的元数据。注意使用 /api 在服务器上是可选的，并且API定义可以托管在完全独立的服务器上
集合元数据	{root}/集合	描述此API中可用数据集合的元数据。
单个集合元数据	{根}/集合/{集合ID}	描述具有唯一标识符{集合ID}的数据集合的元数据
项目元数据	{根}/集合/{集合ID}/项目	检索有关可用项的元数据
查询数据	{root}/集合/{集合ID}/{queryType}	根据查询模式检索数据
查询实例	{根}/集合/{集合ID}/实例	检索有关集合实例的元数据

示例¶

这 demonstration server 通过符合OGC API-环境数据检索标准的接口发布环境数据。客户端应用程序可用 here 。

可用于从METAR观测集合检索数据的示例请求是 here 。

请注意，在本例中，对请求的响应是GeoJSON。

或者，也可以通过以下方式以CoverageJSON格式检索相同的数据 this request 。

请注意，此演示服务器提供来自最近观测的数据，因此您可能需要更新 datetime 参数设置为当天，以便访问可用的METAR观测。