docker-staticmaps is an open-source API for rendering static map images. Easily create maps with markers, polygons, circles, polylines or text, making it perfect for embedding map images on websites or apps. Comes with built-in rate limiting and image caching to optimize performance and protect against abuse.
- ✅ Generate static maps with markers, polygons, circles, polylines and text.
- 🌍 Supports multiple basemaps (OpenStreetMap, Esri, Stamen, Carto, custom tile server).
- ⚡ Easy-to-use REST API - simple integration with any frontend or backend.
- 🐳 Docker-ready for fast, lightweight deployment.
- 🧊 Tile and image caching for performance.
- 🚦 Built-in rate limiting per IP to protect against abuse.
Run the service with Docker:
docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latestSend a sample request:
curl "http://localhost:3000/api/staticmaps?width=1000&height=1000¢er=-18.2871,147.6992&zoom=9&basemap=satellite"
A interactive playground is available at http://localhost:3000
The documentation of the latest development version is in the docs/ subdirectory. A HTML version can be found at https://dietrichmax.github.io/docker-staticmaps/.
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).
Contributions, bug reports and pull requests are welcome.
