maplibre/martin
Martin
Martin is a geospatial data API and vector tile server that delivers map tiles, styles, sprites, and glyphs to web map clients. It functions as a PostGIS vector tile server, generating tiles directly from databases, as well as serving data from MBTiles and PMTiles files.
The project distinguishes itself through a specialized command line interface for managing MBTiles archives, allowing users to validate, compare, and merge offline map data. It also provides dynamic map styling capabilities, including the generation of signed distance field sprites for runtime recoloring and the on-the-fly production of vector font glyphs.
Its broader capabilities include static map image rendering, raster tile generation, and source aggregation to reduce network requests. The server supports data source restriction for security, operational metrics export for monitoring, and feature capping to maintain client-side rendering performance.
The server supports deployment within containerized environments using environment variables or volume-mounted configuration files.
Features
- Vector Tile Serving - Delivers binary geographic map tile data from databases and archives to web clients.
- Vector Tile Generators - Generates map tiles by querying PostGIS databases and converting results into binary vector formats on the fly.
- Geospatial Data APIs - Exposes database tables as tile sources with metadata endpoints and dynamic format conversion.
- MBTiles Storage Adapters - Serves pre-rendered map tiles by reading and indexing binary archives in the MBTiles SQLite format.
- Geospatial Data Distributions - Shares large geospatial datasets through unified endpoints for styles, sprites, and fonts.
- Signed Distance Fields - Generates sprite assets as signed distance fields to enable dynamic runtime recoloring of icons.
- PMTiles Support - Reads map tiles directly from PMTiles archive files via HTTP range requests for serverless delivery.
- Map Visual Styling - Provides dynamic map styling and signed distance field sprites to control geospatial data appearance.
- Fallback Glyph Renderers - Generates and caches glyph ranges from font files, including fallback sequences, to ensure correct rendering.
- Map Style Specifications - Delivers style specification files to clients to define how geospatial map data should be visualized.
- Dynamic Map Asset Generation - Produces map styles, sprites, and font glyphs on the fly to define the visual appearance of map tiles.
- Map Asset Delivery - Delivers map styles, sprites, and font glyphs dynamically to support the map rendering process.
- Vector Glyph Generation - Extracts and caches character ranges from font files into vector glyphs for map text rendering.
- Composite Vector Tile Sources - Aggregates data from multiple tile sources into a single composite response to minimize network requests.
- Resource Metadata Endpoints - Creates standardized metadata endpoints for geospatial tables following the TileJSON specification.
- MBTiles Archive Management - Provides a command line interface to examine, validate, and apply differences between MBTiles archives.
- Archive Validation and Comparison - Provides a command line interface for validating, comparing, and merging MBTiles archive files.
- Sprite Registries - Provides sprite assets in signed distance field format to enable dynamic runtime recoloring of icons.
- Raster and Vector Tile Renderers - Provides rasterized image tiles for clients unable to render vector data.
- Pre-Processed Tile Exports - Generates large sets of tiles for specific bounding boxes and zoom levels for offline use.
- Map Image Export - Renders map views and styles into static image files for documentation and previews.
- Static Map Generators - Creates non-interactive image files of maps at specific coordinates for reports or thumbnails.
- Response Aggregators - Combines data from various spatial origins into a single composite network payload to reduce client-side requests.
- Resource Discovery Endpoints - Provides a central discovery endpoint to list all active tile, sprite, font, and style sources.
- Web Framework Examples - Lightweight tile server for geospatial data.
