How developmentseed/titiler works
Main Components
a. Core Components:
• FastAPI Application Layer
• Core Tiling Engine
• Data Source Handlers (COG, STAC, MosaicJSON, Xarray)
• Extension System
• Tile Matrix Sets Handler (via morecantile)
• Output Formatters (JPEG, PNG, WEBP, etc.)
b. Package Structure:
• titiler.core (Base tiling functionality)
• titiler.xarray (Multi-dimensional data support)
• titiler.extensions (Plugin system)
• titiler.mosaic (MosaicJSON support)
• titiler.application (Demo application)
┌─────────────────────────────────────────────────────┐
• Client Layer │
• ┘
• ↕ HTTP/REST
┌─────────────────────────────────────────────────────┐
• FastAPI Layer │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Routes │ │ Middleware │ │ OpenAPI │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┘
• ↕
┌─────────────────────────────────────────────────────┐
• Core Services │
• ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
• Tile Engine │ │ Factories │ │ Dependencies │ │
• ┘ └─────────────┘ └─────────────┘ │
• ┘
• ↕
┌─────────────────────────────────────────────────────┐
• Data Source Handlers │
• ┌─────────┐ ┌───────┐ ┌────────┐ ┌─────────────┐ │
• COG │ │ STAC │ │ Mosaic │ │ Xarray │ │
• ┘ └───────┘ └────────┘ └─────────────┘ │
• ┘
• ↕
┌─────────────────────────────────────────────────────┐
• External Dependencies │
• ┌─────────┐ ┌──────────┐ ┌────────────────────┐ │
• GDAL │ │ Rasterio │ │ Morecantile │ │
• ┘ └──────────┘ └────────────────────┘ │
• ┘
Important Relationships
• Data flow between components
• Extension points
• API routes to handlers
• Caching mechanisms
• Output format processors
Deployment Options
A separate section showing deployment scenarios:
• AWS Lambda
• ECS
• Kubernetes
• Docker standalone
Additional Elements
• Version information
• Supported file formats
• Scaling points
• Security boundaries
Implementation Details
• Use standard UML notation
• Component interfaces
• Major configuration points
• Stateless/stateful components