Skip to main content

Connect titiler to STAC APIs.

Project description

titiler-stacapi

Connect titiler to STAC APIs

Test Package version 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

To install from sources and run for development:

We recommand using uv as project manager for development.

See https://docs.astral.sh/uv/getting-started/installation/ for installation

git clone https://github.com/developmentseed/titiler-stacapi.git
cd titiler-stacapi

uv sync

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

uv run --extra server 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 Uvicorn 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

titiler_stacapi-1.0.0.tar.gz (34.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

titiler_stacapi-1.0.0-py3-none-any.whl (38.7 kB view details)

Uploaded Python 3

File details

Details for the file titiler_stacapi-1.0.0.tar.gz.

File metadata

  • Download URL: titiler_stacapi-1.0.0.tar.gz
  • Upload date:
  • Size: 34.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for titiler_stacapi-1.0.0.tar.gz
Algorithm Hash digest
SHA256 6b9a1c76cea25158696c08c20f55ef55ac0d305b0da206c871b272579d3051c0
MD5 1b064636783f74f208a0d9639cc94569
BLAKE2b-256 540af27a93847c6337df8de97404e3552eccc2729ad4d8cff526b4f2093aad42

See more details on using hashes here.

File details

Details for the file titiler_stacapi-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: titiler_stacapi-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 38.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for titiler_stacapi-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fb625a38c7dd1294244b5f4d41b7c0eac1709d9ad64dc276bcd310beae5825cc
MD5 12cdc20d229c377cd6cdc1ebe489fff4
BLAKE2b-256 a9a8733d1cbea1f4edee025163d15fa437d39cddeee2e11937143f8821b71c29

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page