No project description provided
Project description
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.
Features
- 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
Installation
$ 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
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.
├── 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.
Contribution & Development
See CONTRIBUTING.md
License
See LICENSE
Authors
Created by Development Seed
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.1.0a9.tar.gz.
File metadata
- Download URL: titiler-0.1.0a9.tar.gz
- Upload date:
- Size: 33.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.9.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1738f7c080cef4357bc63215747654cedde16f576c9e8c266aebf859549f59b5 |
|
| MD5 | 87747c551fdb590895e96e95bcc51ffd |
|
| BLAKE2b-256 | f83f55f6a2faf1e53691e7aaeed3684f1d5f74df13a0d6f08578f3ac4448c64b |
