You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
stac-fastapi-geoparquet can serve a full-featured STAC API from one or more stac-geoparquet files located (e.g.) in blob storage — no database required.
Warning
👷 This project is under active development and may change and break at any time.
Usage
To start a STAC API server pointing to a single stac-geoparquet file:
$ python -m pip install 'stac-fastapi-geoparquet[serve]'
$ STAC_FASTAPI_GEOPARQUET_HREF=data/naip.parquet uvicorn stac_fastapi.geoparquet.main:app
INFO: Started server process [47920]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on https://127.0.0.1:8000 (Press CTRL+C to quit)
This will start the server on https://127.0.0.1:8000.
The collection will be auto-generated from the items in the stac-geoparquet file.
Using collections
Instead of providing the href to a single file, you can provide the href to a file containing a JSON list of collections.
Any collection assets with a application/vnd.apache.parquettype field will be added to the server as sources of items.
For an example, see data/collections.json.
To start a server with one or more collections:
$ STAC_FASTAPI_COLLECTIONS_HREF=data/collections.json uvicorn stac_fastapi.geoparquet.main:app
INFO: Started server process [47920]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on https://127.0.0.1:8000 (Press CTRL+C to quit)
To auto-generate the collections file, we provide a script:
