urbica/martin
Martin
Martin is a vector tile server and map asset server that delivers geospatial data from PostGIS databases, MBTiles, and PMtiles files. It functions as a TileJSON metadata provider and a suite of vector tile tooling for generating, validating, and exporting geospatial tile archives.
The project distinguishes itself by providing integrated map asset management, generating map styles, sprite sheets, and font glyphs on the fly. It supports advanced visual rendering capabilities such as Signed Distance Field sprites for runtime recoloring and fallback-based font composition to ensure complete character coverage.
The server includes capabilities for vector tile optimization, such as combining multiple data sources into single requests and performing on-the-fly vector transcoding. It also provides administrative tools for geospatial data archiving, allowing the bulk export of tiles into static database files for offline use.
The server can be deployed as a container using environment variables or mounted configuration files.
Features
- Vector Tile Serving - Provides high-performance server-side delivery of binary geographic vector map tiles to clients.
- Font Fallback Chains - Combines multiple font sources into a single glyph set to provide fallback characters missing from the primary font.
- Composite Vector Tile Sources - Maps incoming tile requests to various backends including PostGIS databases, MBTiles, and PMtiles files.
- Geospatial Data Archiving - Converts live database tables into static MBtiles or PMtiles files for offline use or distribution.
- MBTiles Serving - Serves and manages map tiles stored in MBTiles and PMtiles archive formats.
- TileJSON Providers - Delivers standardized TileJSON descriptions for each tile source, defining bounds and coordinate systems.
- TileJSON Metadata Providers - Generates standardized TileJSON metadata descriptors that allow map clients to automatically discover and consume geospatial data sources.
- Vector Tile Generation - Retrieves geospatial data for specific bounding boxes and saves them as static binary vector tiles for offline use.
- Map Visual Styling - Provides JSON style specifications and TileJSON metadata to control the visual appearance of map data.
- Map Glyph Generators - Produces specific font character ranges and binary glyphs from font files for client-side map text rendering.
- Map Style Specifications - Serves JSON-based map style specifications that define the visual appearance of geospatial layers.
- Automatic REST Endpoint Generators - Automatically generates standardized TileJSON metadata endpoints from geospatial database tables.
- Dynamic Map Asset Generation - Produces map styles, sprites, and glyphs on the fly to define the visual appearance of vector tiles.
- Map Asset Delivery - Dynamically serves the map styles, sprites, and font glyphs required for client-side vector tile rendering.
- Sprite Generation - Combines multiple sprite sources into a single combined response to reduce HTTP overhead.
- Map Sprite Aggregation - Merges multiple sprite collections into a single request to consolidate map assets for the client.
- SDF - Generates Signed Distance Field versions of icons to enable dynamic color changes at runtime.
- Vector Tile Transcoding - Transforms vector tiles between different binary formats on the fly based on client request headers.
- Sprite Sheet Generators - Generates PNG sprite sheets and JSON indexes from SVG files to serve as map markers.
- Source Restrictions - Controls and limits the database tables and functions available as data sources through configuration.
- File Storage and Metadata Management - Provides command-line utilities to examine, validate, and compare MBTiles database files.
- MBTiles Archive Management - Provides CLI utilities for validating, comparing, and managing binary MBTiles archives.
- Vector Tile Generation - Converts raw geospatial data into optimized binary vector tiles and saves them in bulk to database files.
- Bulk Tile Archiving - Generates tiles in bulk and saves them into archives for offline use or distribution.
- Dynamic Glyph Renderers - Generates dynamic glyph ranges from font files to support text rendering in map clients.
- Signed Distance Fields - Provides sprites as Signed Distance Fields to enable dynamic runtime recoloring of icons.
- SDF - Generates Signed Distance Field (SDF) versions of icons to enable dynamic runtime recoloring by clients.
- Pre-Processed Tile Exports - Converts raw geographic data into optimized vector tile formats like MBTiles prior to deployment.
- On-the-Fly Vector Transcoding - Converts vector tiles between different binary formats on the fly based on client request headers.
- Vector Tile Utilities - Ships a suite of utilities for generating, validating, and exporting geospatial tile archives for offline use and distribution.
- Tile Delivery Optimizations - Reduces latency and bandwidth usage by controlling encoding formats and limiting features per tile.
- Geospatial Data Aggregators - Combines multiple distinct geospatial data sources into a single unified response stream to reduce network overhead.
- Column and Table Access Restrictions - Limits accessible database tables and functions using a permitted sources whitelist to restrict data exposure.
- Static Data Pre-generation - Implements strategies for pre-generating geospatial tiles into static archives to eliminate runtime database bottlenecks.
- Dynamic Glyph Generation - Generates dynamic glyph ranges from font files to support text rendering in map clients.
- HTTP Response Combiners - Merges multiple data streams into a single composite HTTP response to minimize network requests.
- Static Asset Serving - Serves static SVG sprites, font files, and style sheets required for full map rendering.
- Geospatial Servers and APIs - PostGIS vector tile server built with Actix.
- Geospatial Development Libraries - PostGIS vector tiles server built with Rust.
