Kepler Raster Server

A raster tile server built on top of TiTiler by Development Seed, providing terrain mesh and STAC mosaic capabilities. All TiTiler licenses and attributions apply to this project.

Features

• Terrain Mesh Generation: Generate quantized mesh terrain tiles for 3D visualization for STAC raster tiles and .pmtiles in raster format
• STAC Mosaic Support: Dynamic STAC API integration for tile serving

Installation

Local Development

1. Clone the repository:

git clone https://github.com/yourusername/kepler-raster-server.git
cd kepler-raster-server

2. Build and run with Docker locally:

# Enable Docker BuildKit for better caching
export DOCKER_BUILDKIT=1
docker-compose up --build titiler

The raster tile server will be available at http://localhost:8000 and can be used to setup a raster tile layer in kepler.gl during development.

API Endpoints

The following endpoints are required for raster tile layer in kepler.gl.

STAC Items

• /cog/tiles/WebMercatorQuad/{z}/{x}/{y}.npy - Get stac items in npy format

STAC Mosaic

• /stac/mosaic/tiles/{z}/{x}/{y}.npy - Get mosaic tiles in npy format

Terrain Mesh

• /mesh/tiles/{z}/{x}/{y}.terrain - Get quantized mesh suitable with QuantizedMeshLoader from loaders.gl

Deployment

AWS Lambda Deployment

Follow the TiTiler AWS Lambda deployment guide for serverless deployment. Note that you'll need enough concurrency to support lambda instance per request. In kepler.gl at this moment raster tile layer issues 6 requests per raster server during loading (or 12 when elevation meshes are enabled). Make sure to setup enough Lambda concurrency, reserved concurency or provisioned concurrency to prevent 503 Service not available message when there are more requests then available simultaneous Lambda instances. Make sure to control your expenses and don't share your server URL publicly unless intended.

If you need to process many requests concurrently more reliably:

• Use AWS Fargate, ECS, or EC2 where multi-threaded or async server logic is supported
• See the TiTiler AWS deployment guide for more details

Using in Your Application

To use the server in your Python application:

from kepler_raster_server import app as kepler_app

Publishing to PyPI

To publish a new version to PyPI:

1. Update the version in pyproject.toml
2. Run the publish script:

./scripts/publish.sh

License

This project is licensed under the MIT License - see the LICENSE file for details.

Attribution

This project is built on top of TiTiler by Development Seed, which is also licensed under the MIT License. All TiTiler licenses and attributions apply to this project.

Credits

• TiTiler by Development Seed - The base tile server implementation
• Development Seed - For their excellent work on TiTiler and related geospatial tools