A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.
Project description
A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.
Documentation: https://devseed.com/titiler/
Source Code: https://github.com/developmentseed/titiler
Titiler, pronounced tee-tiler (ti is the diminutive version of the french petit which means small), is a lightweight application (FastAPI) focused on creating web map tiles dynamically from Cloud Optimized GeoTIFF, STAC or MosaicJSON.
Note: This project is the descendant of cogeo-tiler and cogeo-mosaic-tiler.
Features
- Cloud Optimized GeoTIFF support
- SpatioTemporal Asset Catalog support
- Virtual mosaic support (via MosaicJSON)
- Multiple projections (see TileMatrixSets) via
morecantile. - JPEG / JP2 / PNG / WEBP / GTIFF / NumpyTile output format support
- OGC WMTS support
- Automatic OpenAPI documentation (FastAPI builtin)
- Example of AWS Lambda / ECS deployment (via CDK)
Installation
$ pip install -U pip
# From Pypi
$ pip install titiler
# Or from sources
$ git clone https://github.com/developmentseed/titiler.git
$ cd titiler && pip install -e .
Launch Application
$ uvicorn titiler.main:app --reload
Or with Docker
$ git clone https://github.com/developmentseed/titiler.git
$ cd titiler
$ export AWS_ACCESS_KEY_ID=...
$ export AWS_SECRET_ACCESS_KEY=...
$ docker-compose build
$ docker-compose up
Docker
Ready to use/deploy images can be found on Docker Hub and AWS public ECR registery.
docker run --name titiler \
-p 8000:8000 \
--env PORT=8000 \
--env WORKERS_PER_CORE=1 \
--rm -it developmentseed/titiler
docker run --name titiler \
-p 8000:8000 \
--env PORT=8000 \
--env WORKERS_PER_CORE=1 \
--rm -it public.ecr.aws/developmentseed/titiler
Some options can be set via environment variables, see: https://github.com/tiangolo/uvicorn-gunicorn-docker#advanced-usage
Project structure
titiler/ - titiler python module.
├── custom/ - Custom colormap and TMS grids.
├── endpoints - API routes.
│ ├── cog.py - COG related endpoints.
│ ├── stac.py - STAC related endpoints.
│ ├── mosaic.py - MosaicJSON related endpoints.
│ ├── factory.py - TiTiler Router Factories.
│ └── tms.py - TileMatrixSets endpoints.
├── models/ - pydantic models for this application.
├── resources/ - application resources (enums, constants, etc.).
├── templates/ - html/xml models.
├── middleware.py - Custom Starlette middlewares.
├── dependencies.py - API dependencies.
├── errors.py - API custom error handling.
├── main.py - FastAPI application creation and configuration.
├── settings.py - application configuration.
└── utils.py - utility functions.
Contribution & Development
See CONTRIBUTING.md
License
See LICENSE
Authors
Created by Development Seed
See contributors for a listing of individual contributors.
Changes
See CHANGES.md.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file titiler-0.2.0.tar.gz.
File metadata
- Download URL: titiler-0.2.0.tar.gz
- Upload date:
- Size: 42.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4387a74fa2f2621e74b1510204a1fc61e313d7369d2765eedb7e91da3618c4d6 |
|
| MD5 | 9ffb03ed5932ea029aa16b5b61521ee9 |
|
| BLAKE2b-256 | f7a3950c20169cd222d689f55a6dd99294a6259fe56d7cd1a824be4471a48ec6 |
