基于FastAPI和Rasterio/GDAL的现代动态瓦片服务器。
项目描述
基于FastAPI和Rasterio/GDAL的现代动态瓦片服务器。
文档: https://devseed.com/titiler/
源代码: https://github.com/developmentseed/titiler
Titiler
,发音为 tee-tiler (ti 是法语 petit 的缩写,意为小),是一组专注于创建动态瓦片FastAPI应用的Python模块。
注意:本工程是 cogeo-tiler
和 cogeo-mosaic-tiler
的后裔。
特性
- 基于 FastAPI 构建
- 支持 Cloud Optimized GeoTIFF
- 支持 SpatioTemporal Asset Catalog
- 支持多种投影(参见 TileMatrixSets),通过
morecantile
实现。 - 支持 JPEG / JP2 / PNG / WEBP / GTIFF / NumpyTile 输出格式
- 支持 OGC WMTS
- 自动 OpenAPI 文档(FastAPI 内置)
- 支持虚拟拼图(通过 MosaicJSON)
- AWS Lambda / ECS 部署示例(通过 CDK)
包
从版本 0.3.0
开始,TiTiler
Python 模块已被拆分为一组 Python 命名空间包:titiler.{package}
。
包 | 版本 | 描述 |
---|---|---|
titiler.core | Core 包包含用于创建 COG 和 STAC 的动态瓦片库 |
|
titiler.extensions | Titiler 的扩展包。包含 Tiler 工厂扩展 | |
titiler.mosaic | mosaic 包包含用于创建 MosaicJSON 的动态瓦片库(添加 cogeo-mosaic 依赖项) |
|
titiler.application | Titiler 的 demo 包。包含一个支持 COG、STAC 和 MosaicJSON 的完整 FastAPI 应用程序 |
安装
从 PyPI 安装并运行
# 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
从源代码安装并运行以进行开发
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
可在 Github 仓库中找到可用于使用/部署的镜像。
docker run --name titiler \
-p 8000:8000 \
--env PORT=8000 \
--env WORKERS_PER_CORE=1 \
--rm -it ghcr.io/developmentseed/titiler:latest
- 本地构建 Docker
git clone https://github.com/developmentseed/titiler.git
cd titiler
docker compose up --build titiler # or titiler-uvicorn
可以通过环境变量设置一些选项,请参阅:https://github.com/tiangolo/uvicorn-gunicorn-docker#advanced-usage
项目结构
src/titiler/ - titiler modules.
├── application/ - Titiler's `Application` package
├── extensions/ - Titiler's `Extensions` package
├── core/ - Titiler's `Core` package
└── mosaic/ - Titiler's `Mosaic` package
贡献 & 开发
请参阅 CONTRIBUTING.md
许可证
请参阅 LICENSE
作者
由 Development Seed 创建
请参阅 contributors 获取个人贡献者的列表。
变更
请参阅 CHANGES.md。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解有关 安装软件包 的更多信息。
源分发
titiler-0.18.9.tar.gz (5.8 kB 查看哈希值)
构建分发
titiler-0.18.9-py3-none-any.whl (4.8 kB 查看哈希值)