Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/developmentseed/titiler
Build your own Raster dynamic map tile services
https://github.com/developmentseed/titiler
aws-cdk aws-lambda cog cogeotiff dynamic fastapi gdal map-tile-server map-tiles mosaicjson raster rasterio rest server stac tile
Last synced: about 1 month ago
JSON representation
Build your own Raster dynamic map tile services
- Host: GitHub
- URL: https://github.com/developmentseed/titiler
- Owner: developmentseed
- License: mit
- Created: 2019-06-28T16:54:56.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-05-07T08:04:48.000Z (about 1 month ago)
- Last Synced: 2024-05-15T02:06:10.602Z (about 1 month ago)
- Topics: aws-cdk, aws-lambda, cog, cogeotiff, dynamic, fastapi, gdal, map-tile-server, map-tiles, mosaicjson, raster, rasterio, rest, server, stac, tile
- Language: Python
- Homepage: https://developmentseed.org/titiler/
- Size: 46 MB
- Stars: 705
- Watchers: 19
- Forks: 145
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Lists
- Awesome-Geospatial - titiler - A dynamic Web Map tile server. (Web Map Development)
- awesome-earthobservation-code - titiler - A modern dynamic tile server built on top of `FastAPI` and `Rasterio/GDAL`. (`Python` processing of optical imagery (non deep learning) / Cloud Native Geospatial)
- awesome-fastapi - :octocat: titiler :star: 300+ :fork_and_knife: 80+ - Build your own Raster dynamic map tile services. (APIs)
README
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 set of python modules that focus on creating FastAPI application for dynamic tiling.
Note: This project is the descendant of [`cogeo-tiler`](https://github.com/developmentseed/cogeo-tiler) and [`cogeo-mosaic-tiler`](https://github.com/developmentseed/cogeo-mosaic-tiler).
## Features
- Built on top of [FastAPI](https://fastapi.tiangolo.com)
- [Cloud Optimized GeoTIFF](http://www.cogeo.org/) support
- [SpatioTemporal Asset Catalog](https://stacspec.org) support
- Multiple projections support (see [TileMatrixSets](https://www.ogc.org/standards/tms)) via [`morecantile`](https://github.com/developmentseed/morecantile).
- JPEG / JP2 / PNG / WEBP / GTIFF / NumpyTile output format support
- OGC WMTS support
- Automatic OpenAPI documentation (FastAPI builtin)
- Virtual mosaic support (via [MosaicJSON](https://github.com/developmentseed/mosaicjson-spec/))
- Example of AWS Lambda / ECS deployment (via CDK)
## Packages
Starting with version `0.3.0`, the `TiTiler` python module has been split into a set of python namespace packages: `titiler.{package}`.
| Package | Version | Description
| ------- | ------- |-------------
[**titiler.core**](https://github.com/developmentseed/titiler/tree/main/src/titiler/core) | [](https://pypi.org/project/titiler.core) | The `Core` package contains libraries to help create a dynamic tiler for COG and STAC
[**titiler.extensions**](https://github.com/developmentseed/titiler/tree/main/src/titiler/extensions) | [](https://pypi.org/project/titiler.extensions) | TiTiler's extensions package. Contains extensions for Tiler Factories.
[**titiler.mosaic**](https://github.com/developmentseed/titiler/tree/main/src/titiler/mosaic) | [](https://pypi.org/project/titiler.mosaic) | The `mosaic` package contains libraries to help create a dynamic tiler for MosaicJSON (adds `cogeo-mosaic` requirement)
[**titiler.application**](https://github.com/developmentseed/titiler/tree/main/src/titiler/application) | [](https://pypi.org/project/titiler.application) | TiTiler's `demo` package. Contains a FastAPI application with full support of COG, STAC and MosaicJSON
## Installation
To install from PyPI and run:
```bash
# Make sure you have pip up to date
python -m pip install -U pip
python -m pip install titiler.{package}
# e.g.,
# python -m pip install titiler.core
# python -m pip install titiler.extensions
# python -m pip install titiler.mosaic
# python -m pip install titiler.application (also installs core, extensions and mosaic)
# Install uvicorn to run the FastAPI application locally
python -m pip install uvicorn
# Launch application locally
uvicorn titiler.application.main:app
```
To install from sources and run for development:
```
git clone https://github.com/developmentseed/titiler.git
cd titiler
python -m pip install -U pip
python -m pip install -e src/titiler/core -e src/titiler/extensions -e src/titiler/mosaic -e src/titiler/application
python -m pip install uvicorn
uvicorn titiler.application.main:app --reload
```
## Docker
Ready to use/deploy images can be found on Github registry.
- https://github.com/developmentseed/titiler/pkgs/container/titiler
```bash
docker run --name titiler \
-p 8000:8000 \
--env PORT=8000 \
--env WORKERS_PER_CORE=1 \
--rm -it ghcr.io/developmentseed/titiler:latest
```
- Built the docker locally
```
git clone https://github.com/developmentseed/titiler.git
cd titiler
docker-compose up --build titiler # or titiler-uvicorn
```
Some options can be set via environment variables, see: https://github.com/tiangolo/uvicorn-gunicorn-docker#advanced-usage
## Project structure
```
src/titiler/ - titiler modules.
├── application/ - Titiler's `Application` package
├── extensions/ - Titiler's `Extensions` package
├── core/ - Titiler's `Core` package
└── mosaic/ - Titiler's `Mosaic` package
```
## Contribution & Development
See [CONTRIBUTING.md](https://github.com/developmentseed/titiler/blob/main/CONTRIBUTING.md)
## License
See [LICENSE](https://github.com/developmentseed/titiler/blob/main/LICENSE)
## Authors
Created by [Development Seed]()
See [contributors](https://github.com/developmentseed/titiler/graphs/contributors) for a listing of individual contributors.
## Changes
See [CHANGES.md](https://github.com/developmentseed/titiler/blob/main/CHANGES.md).