Skip to content

Monitoring network mockup

David Blodgett edited this page Jul 21, 2020 · 8 revisions

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

/collections

Lists all collections including collection info.

/collections/{collectionID}

Lists collection info for the selected CollectionID.

/collections/{collectionID}/items

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 uri.)

e.g.

{
  "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": [
      "velocity",
      "temperature"
    ],
    "uri": "https://.../collections/{cid}/locations/{lid}"
  },
  "id": "fid",
  "links": [
    {
      "rel": "self",
      "type": "application/geo+json",
      "title": "This document as GeoJSON",
      "href": "https://.../collections/{cid}/items/{fid}?f=json"
    },
    {
      "rel": "alternate",
      "type": "text/html",
      "title": "This document as HTML",
      "href": "https://.../collections/{cid}/locations/{fid}?f=html"
    },
    {
      "rel": "alternate",
      "type": "application/prs.coverage+json",
      "title": "This location as coverage JSON",
      "href": "https://.../collections/{cid}/locations/{fid}"
    }
    {
      "rel": "collection",
      "type": "application/json",
      "title": "Reference Gages",
      "href": "https://.../collections/{cid}"
    }
  ]
}

/collections/{collectionID}/locations

Provides access to timeseries data for monitoring locations. These can be discovered through the .../items endpoint.

/collections/{collectionID}/locations/{featureID}

Provides access to the timeseries data for a particular monitoring location with EDR query parameters to filter on parameter and time.

Clone this wiki locally