An Environmental Data Retrieval (EDR) API provides a family of lightweight interfaces to access Environmental Data resources. Each resource addressed by an EDR API maps to a defined query pattern. This specification identifies resources, captures compliance classes, and specifies requirements which are applicable to OGC Environmental Data Retrieval API’s. This specification addresses two fundamental operations; discovery and query. Discovery operations allow the API to be interrogated to determine its capabilities and retrieve information (metadata) about this distribution of a resource. This includes the API definition of the server as well as metadata about the Environmental Data resources provided by the server. Query operations allow Environmental Data resources to be retrieved from the underlying data store based upon simple selection criteria, defined by this standard and selected by the client.
The OGC API - Environmental Data Retrieval Standard provides a family of lightweight query interfaces to access spatio-temporal data resources by requesting data at a Position, within an Area, along a Trajectory or through a Corridor.
The OGC API - Environmental Data Retrieval - Part 2: Publish-Subscribe Workflow Standard provides recommendations on applying Publish-Subscribe (PubSub) architectural patterns to implementations of one or more OGC API Standards in order to support Event Driven applications.
Overview
- Visit the overview page to learn more about this API.
Developer-friendly OpenAPI and AsyncAPI definitions
- Environmental Data Retrieval API example using ReDoc and conforming to the OpenAPI specification
- Environmental Data Retrieval API example on SwaggerHub and conforming to the OpenAPI specification
- Example description of a Publish-Subscribe (PubSub) enabled Environmental Data Retrieval API on SwaggerHub and conforming to the AsyncAPI specification
- Schema Repository
Archives of API definitions of previous versions of the standard are also available.
Standards Documents
The standards can be found at:
Development
Development of the standards takes place on GitHub.
Implementers
OGC Compliance Certification
Compliance tests for OGC API - Environmental Data Retrieval are available on the OGC Validator.
You can Get Certified as OGC Compliant through the process described on the OGC Compliance website.