SpatioTemporal Asset Catalog (STAC) API Support

Versions

pycsw supports SpatioTemporal Asset Catalog API version 1.0.0-beta2 by default.

pycsw implements provides STAC support in the following manner:

  • a pycsw repository is equivalent to a STAC collection
  • pycsw metadata records are equivalent to STAC items

The STAC specification is designed with the same principles as OGC API - Records.

Request Examples

As the OGC successor to CSW, OARec is a change in paradigm rooted in lowering the barrier to entry, being webby/of the web, and focusing on developer experience/adoption. JSON and HTML output formats are both supported via the f parameter.

# landing page
http://localhost:8000/
# landing page explictly as JSON
http://localhost:8000/?f=json
# landing page as HTML
http://localhost:8000/?f=html

# collection queries
# query parameters can be combined (exclusive/AND)

# collection query, all records
http://localhost:8000/search/items
# collection query, full text search
http://localhost:8000/search/items?q=lorem
# collection query, spatial query
http://localhost:8000/search/items?bbox=-142,42,-52,84
# collection query, temporal query
http://localhost:8000/search/items?datetime=2001-10-30/2007-10-30
# collection query, temporal query, before
http://localhost:8000/search/items?datetime=../2007-10-30
# collection query, temporal query, after
http://localhost:8000/search/items?datetime=2007-10-30/..
# collection query, property query
http://localhost:8000/search/items?title=Lorem%20ipsum
# collection query, CQL filter
http://localhost:8000/search/items?filter=title like "%lorem%"
# collection query, limiting results
http://localhost:8000/search/items?limit=1
# collection query, paging
http://localhost:8000/search/items?limit=10&startindex=10

# collection item as GeoJSON
http://localhost:8000/collections/metadata:main/items/{itemId}
# collection item as HTML
http://localhost:8000/collections/metadata:main/items/{itemId}?f=html
# collection item as XML
http://localhost:8000/collections/metadata:main/items/{itemId}?f=xml