Skip to content

developmentseed/titiler-stacapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7d479f3 · Feb 25, 2025

History

82 Commits
Jun 11, 2024
Apr 8, 2024
Jun 10, 2024
Apr 17, 2024
Feb 25, 2025
Feb 25, 2025
Apr 17, 2024
Mar 19, 2024
Mar 20, 2024
Feb 25, 2025
Mar 20, 2024
Mar 19, 2024
Aug 20, 2024
Jun 10, 2024
Jun 11, 2024

Repository files navigation

titiler-stacapi

Connect titiler to STAC APIs

Test Coverage License


Documentation: https://developmentseed.org/titiler-stacapi/

Source Code: https://github.com/developmentseed/titiler-stacapi


Installation

To install from PyPI and run:

# Make sure you have pip up to date
python -m pip install -U pip
python -m pip  install titiler.stacapi

or from sources and run for development:

git clone https://github.com/developmentseed/titiler-stacapi.git
cd titiler-stacapi
python -m pip install -e .

Launch

You'll need to have TITILER_STACAPI_STAC_API_URL variables set in your environment pointing to your STAC API service.

export TITILER_STACAPI_STAC_API_URL=https://api.stac
python -m pip install uvicorn

uvicorn titiler.stacapi.main:app --port 8000

Using Docker

$ git clone https://github.com/developmentseed/titiler-stacapi.git
$ cd titiler-stacapi
$ export TITILER_STACAPI_STAC_API_URL=https://api.stac
$ docker-compose up --build api

It runs titiler.stacapi using Gunicorn web server.

How it works

WMTS and the Render extension

titiler-stacapi makes extensive use of the Render extension, specifically at the Collection level. By using the render's metadata, the /wmts endpoint (from the OGCWMTSFactory factory) can populate a set of layers returned by the GetCapabilities service.

Contribution & Development

See CONTRIBUTING.md

License

See LICENSE

Authors

See contributors for a listing of individual contributors.

Changes

See CHANGES.md.