Self-hostable REST API for rendering static map images with markers, polygons, circles, polylines and text overlays. Includes tile caching, per-IP rate limiting and optional API key auth.

Documentation: https://dietrichmax.github.io/docker-staticmaps/

Features

• Markers, polygons, circles, polylines and text overlays
• Multiple basemaps (OpenStreetMap, Esri, Carto) and custom tile servers
• Optional hillshade overlay (Terrarium-encoded raster-DEM tiles)
• Tile and image caching
• Per-IP rate limiting
• Optional API key authentication

Quickstart

Run with Docker:

docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest

Sample request:

curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite"

!Minimal Example

An interactive playground is available at http://localhost:3000.

!Interactive playground

License

Copyright (C) 2026 Max Dietrich

The source code of this project is licensed under the GNU Affero General Public License version 3 or later (AGPL-3.0+).

Portions of this project (in the staticmaps folder) were originally based on staticmaps (MIT License).

Contributing

Contributions, bug reports and pull requests are welcome.