Documentation
Learn how to process and style your vector datasets
Vector Processing
Upload and process vector datasets using our secure toolkit
Vector Styling
Customize vector tile appearance with Maputnik
API Reference
Technical details and integration guides
Vector Processing
Upload and process vector datasets locally
Overview
Our vector processing toolkit allows you to convert various vector formats into optimized vector tiles while keeping your data secure on your local machine.
Supported Formats
Modern, efficient format with multiple layers
Traditional format with associated files
Web-friendly JSON format
Google Earth compatible format
Vector Styling
Customize vector tile appearance with Maputnik
What is Maputnik?
Maputnik is an open-source visual editor for creating Mapbox GL JS styles. It provides an intuitive interface for styling vector tiles without writing code, making it perfect for designers and developers alike.
Streamlined Workflow
Our new download/upload functionality makes it easier than ever to work with Maputnik. Download a complete style template with your vector tile URL already configured, edit it in Maputnik, and upload it back.
Download Style Template
Get a complete Mapbox GL JS style file with your vector tile URL and current symbology already configured.
Upload Styled File
Upload your edited Mapbox GL JS style file and automatically extract the symbology for your dataset.
Step-by-Step Styling Guide
Download Your Style Template
In your dataset details, click "Edit Styles" and use the "Download Mapbox Style" button to get a complete style file with your vector tile URL already configured.
Your dataset style template with configured URLsOpen in Maputnik
Open Maputnik and import your downloaded style file. This will load your vector tiles with the current symbology, ready for editing.
Style Your Layers
Use Maputnik's visual interface to customize colors, line widths, point sizes, and other visual properties for each layer. Preview changes in real-time.
Export and Upload
Export your styled map from Maputnik as a Mapbox GL JS style file, then upload it back to your dataset using the "Upload Mapbox Style" button.
Save and Apply
Review the extracted symbology and save it to your dataset. The new styles will be applied immediately to your vector tiles in the map viewer.
Alternative: Manual URL Method
If you prefer to work directly with the vector tile URL, you can copy it from the symbology editor and paste it into Maputnik's source URL field.
Copy the vector tile URL from your dataset's symbology section
In Maputnik, add a new source and paste the URL
Style your layers and export the complete style file
Upload the style file back to your dataset
Style Properties Reference
Points
circle-colorPoint fill color
circle-radiusPoint size in pixels
circle-opacityTransparency (0-1)
circle-stroke-colorBorder color
Lines
line-colorLine color
line-widthLine thickness
line-opacityTransparency (0-1)
line-dasharrayDashed line pattern
Polygons
fill-colorFill color
fill-opacityTransparency (0-1)
fill-outline-colorBorder color
fill-patternPattern fill
Pro Tips
Zoom-based expressions
Use zoom levels for responsive styling
Test at different zooms
Preview styles across zoom levels
Data-driven styling
Use feature properties for dynamic colors
Keep it simple
Simple styles perform better
API Reference
Technical details and integration guides
Vector Tile Endpoints
PMTiles Endpoint
GET /api/tiles/pmtiles/{datasetId}?token={token}Serves vector tiles in PMTiles format for direct consumption by MapLibre GL JS
Dataset Metadata
GET /api/datasets/{datasetId}Returns dataset information including symbology and metadata
Toolkit Integration
Docker Command
docker run --rm -v /path/to/vector.gpkg:/data/vector.gpkg paschendale/territorial-toolkit:latest process-vector --token {token} --file /data/vector.gpkg --name "My Dataset"Process vector files locally with our secure toolkit
Supported Formats
Ready to Get Started?
Upload your vector dataset and start styling with Maputnik today.