b12cc966a1
* first pass docs scaffolding * more updates * introduction, how pygeoapi works, installation * start documenting configuration * configuration and linked data * administration * administration, running * docker * linked data into config * minor updates * api docs * add mod_wsgi info * add OpenAPI refresh * add tour, data-publishing * license * OAPIF * data publishing: OAPIF * publishing * plugins * contributing, support * development, ogc compliance * fix flake8
37 lines
998 B
ReStructuredText
37 lines
998 B
ReStructuredText
.. _stac:
|
|
|
|
Publishing files to a SpatioTemporal Asset Catalog
|
|
==================================================
|
|
|
|
The `SpatioTemporal Asset Catalog (STAC)`_ specification provides an easy approach
|
|
for describing geospatial assets. STAC is typically implemented for imagery and
|
|
other raster data.
|
|
|
|
pygeoapi implements STAC as an geospatial file browser through the FileSystem provider,
|
|
supporting any level of of file / directory nesting/hierarchy.
|
|
|
|
Configuring STAC in pygeoapi is done by simply pointing the ``data`` provider property
|
|
to the given directory:
|
|
|
|
.. code-block:: yaml
|
|
|
|
provider:
|
|
name: FileSystem
|
|
data: /Users/tomkralidis/Dev/data/gdps
|
|
file_types:
|
|
- .grib2
|
|
|
|
|
|
.. note::
|
|
``rasterio`` and ``fiona`` are required for describing geospatial files.
|
|
|
|
Data access examples
|
|
--------------------
|
|
|
|
- STAC root page
|
|
- http://localhost:5000/stac
|
|
|
|
From here, browse the filesystem accordingly.
|
|
|
|
.. _`SpatioTemporal Asset Catalog (STAC)`: https://stacspec.org
|