Monitoring network mockup
This mockup is intended to provide a minimal example of the Environmental Data Retrieval API used with a network of monitoring station data that can provide data as timeseries.
Provides basic information about the API
Lists all collections including collection info.
Unroll for JSON Example
{
"links": [
{
"href": "http://www.example.org/edr/collections/",
"hreflang": "en",
"rel": "self",
"type": "application/json"
},
{
"href": "http://www.example.org/edr/collections/",
"hreflang": "en",
"rel": "alternate",
"type": "text/html"
},
{
"href": "http://www.example.org/edr/collections/",
"hreflang": "en",
"rel": "alternate",
"type": "application/xml"
}
],
"collections": [
{
"id": "stream_gage",
"title": "Stream Gage Observations",
"description": "Observations from stream gages operated by the USGS.",
"keywords": [
"streamflow",
"stage"
],
"extent": {
"spatial": {
"bbox": [
-15.0,
48.0,
5.0,
62.0
],
"crs": "GEOGCS[\"WGS 84\",DATUM[\"WGS_1984\",SPHEROID[\"WGS 84\",6378137,298.257223563,AUTHORITY[\"EPSG\",\"7030\"]],AUTHORITY[\"EPSG\",\"6326\"]],PRIMEM[\"Greenwich\",0,AUTHORITY[\"EPSG\",\"8901\"]],UNIT[\"degree\",0.01745329251994328,AUTHORITY[\"EPSG\",\"9122\"]],AUTHORITY[\"EPSG\",\"4326\"]]"
},
"temporal": {
"interval": [
"2020-04-19T11:00:00Z/2020-06-30T09:00:00Z"
],
"trs": "TIMECRS[\"DateTime\",TDATUM[\"Gregorian Calendar\"],CS[TemporalDateTime,1],AXIS[\"Time (T)\",future]"
}
},
"crs": [
{
"name": "CRS84",
"wkt": "GEOGCS[\"WGS 84\",DATUM[\"WGS_1984\",SPHEROID[\"WGS 84\",6378137,298.257223563,AUTHORITY[\"EPSG\",\"7030\"]],AUTHORITY[\"EPSG\",\"6326\"]],PRIMEM[\"Greenwich\",0,AUTHORITY[\"EPSG\",\"8901\"]],UNIT[\"degree\",0.01745329251994328,AUTHORITY[\"EPSG\",\"9122\"]],AUTHORITY[\"EPSG\",\"4326\"]]"
}
],
"distanceunits": [
"km",
"miles"
],
"outputformat": [
{
"name": "GeoJSON",
"data_schema": "http://www.example.org/edr/static/json/dp_schema.json"
},
{
"name": "CoverageJSON"
}
],
"parameters": {
"daily_streamflow": {
"type": "Parameter",
"description": {
"en": "Daily Streamflow"
},
"unit": {
"label": {
"en": "Cubic Feet per Second"
},
"symbol": {
"value": "ft³/s",
"type": "http://www.example.org/edr/metadata/units/cfs"
}
},
"observedProperty": {
"id": "https://waterdata.usgs.gov/nwisweb/rdf?parmCd=00060",
"label": {
"en": "Streamflow"
}
},
"measurementType": {
"method": "mean",
"period": "P1D"
}
},
"gage_height": {
"type": "Parameter",
"description": {
"en": "Instantaneous River Stage"
},
"unit": {
"label": {
"en": "ft"
},
"symbol": {
"value": "ft",
"type": "http://www.example.org/edr/metadata/units/ft"
}
},
"observedProperty": {
"id": "https://waterdata.usgs.gov/nwisweb/rdf?parmCd=00065",
"label": {
"en": "Gage Height"
}
},
"measurementType": {
"method": "instantaneous"
}
}
},
"links": [
{
"href": "http://www.example.org/service-doc",
"hreflang": "en",
"rel": "service-doc",
"type": "text/html",
"title": "license"
},
{
"href": "http://www.example.org/license",
"hreflang": "en",
"rel": "license",
"type": "text/html",
"title": "license"
},
{
"href": "http://www.example.org/edr/collections/stream_gages/position",
"hreflang": "en",
"rel": "data",
"type": "position",
"title": "position"
},
{
"href": "http://www.example.org/edr/collections/stream_gages/radius",
"hreflang": "en",
"rel": "data",
"type": "radius",
"title": "radius"
},
{
"href": "http://www.example.org/edr/collections/stream_gages/area",
"hreflang": "en",
"rel": "data",
"type": "area",
"title": "area"
},
{
"href": "http://www.example.org/edr/collections/stream_gages/locations",
"hreflang": "en",
"rel": "data",
"type": "location",
"title": "location"
},
{
"href": "http://www.example.org/edr/collections/stream_gages/items",
"hreflang": "en",
"rel": "data",
"type": "items",
"title": ""
}
]
}
]
}OGC API Features interface that provides geoJSON, temporal, and parameter metadata for each item. This is ostensibly the catalog of data available from this EDR API as sampling features that already exist / are discoverable. For EDR, this would adhere to the EDRFeatureCollectionGeoJSON JSON Schema (properties declared here include: datetime, parametername, label, and edrqueryendpoint.)
Unroll for JSON Example
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-69.7155556,
46.70055555999999
]
},
"properties": {
"datetime": "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z",
"label": "Monitoring site name",
"parametername": [
"daily_streamflow",
"gage_height"
],
"edrqueryendpoint": "https://labs.waterservices.usgs.gov/collections/stream_gage/locations/0123456789"
},
"id": "0123456789",
"links": [
{
"rel": "self",
"type": "application/geo+json",
"title": "This document as GeoJSON",
"href": "https://labs.waterservices.usgs.gov/collections/stream_gage/items/0123456789?f=json"
},
{
"rel": "alternate",
"type": "text/html",
"title": "This document as HTML",
"href": "https://labs.waterservices.usgs.gov/collections/stream_gage/items/0123456789?f=html"
},
{
"rel": "collection",
"type": "application/json",
"title": "Reference Gages",
"href": "https://labs.waterservices.usgs.gov/collections/stream_gage/"
}
]
}Provides access to timeseries data for monitoring locations. These can be discovered through the .../items endpoint.
Provides access to the timeseries data for a particular monitoring location with EDR query parameters to filter on parameter and time.
See issue https://github.com/opengeospatial/ogcapi-environmental-data-retrieval/issues/373
A prototype is implemented in pygeoapi in https://github.com/tomkralidis/pygeoapi/tree/ogc-edr-sprint-2022-05
