A lightweight Cloud Optimized GeoTIFF dynamic tile server.
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 server to create map tiles dynamically from Cloud Optimized GeoTIFF (COG).
This project is the descendant of cogeo-tiler
and cogeo-mosaic-tiler
.
- Cloud Optimized GeoTIFF support
- SpatioTemporal Asset Catalog support
- Mosaic support (via MosaicJSON)
- Multiple tiling projections (TileMatrixSets) via
morecantile
. By default, output map tiles are in the standard Web Mercator projection used by most mapping libraries, but support for alternative projections is available. - OGC WMTS support
- AWS Lambda / ECS deployment options
$ pip install -U pip
$ pip install titiler["server"]
# Or from sources
$ git clone https://github.com/developmentseed/titiler.git
$ cd titiler && pip install -e .["server"]
Launch Application
$ pip install -e .
$ 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
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.
├── ressources/ - application resources (enums, constants, etc.).
├── templates/ - html/xml models.
├── 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.
│
stack/
├── app.py - AWS Stack definition (vpc, cluster, ecs, alb ...)
├── config.py - Optional parameters for the stack definition [EDIT THIS]
│
Dockerfiles/
├── ecs/
│ └── Dockerfile - Dockerfile to build the ECS service image.
├── lambda/
│ └── Dockerfile - Dockerfile to build the Lambda service image.
│
lambda/
│ └── handler.py - Mangum adaptor for AWS Lambda.
│
docs/ - Project documentation.
See CONTRIBUTING.md
See LICENSE
Created by Development Seed
See CHANGES.md.