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.

🚀 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/