Docker Static Maps API 🗺️

Generate static map images via a lightweight REST API

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.

The Dockerfile and the README are from this original repository: https://github.com/dietrichmax/docker-staticmaps

🚀 Features

• ✅ 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

📖 Quick Start

Once deployed, you can access the interactive playground at your domain, or make API requests directly.

Example API Request

GET https://your-domain.zeabur.app/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite

Interactive Playground

Visit your deployed domain to access the interactive playground where you can:

• Configure map settings visually
• Add markers, polygons, and other features
• Preview the generated map in real-time
• Copy the API URL for integration

📚 Documentation

For detailed API documentation, supported basemaps, and advanced features, visit: https://dietrichmax.github.io/docker-staticmaps/

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0)

docker-staticmaps
Copyright (C) 2026 Max Dietrich

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.