Skip to content
Projects

dietrichmax/docker-staticmaps

View on GitHub

dietrichmax/docker-staticmaps has 131 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours and +1 in 7 days. Last checked 2026-11-17 02:09 UTC. Last push 2026-11-15.

How these counts are measured

What you can do

  • 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

Measured star growth

in 24h
0
in 7 days
+1
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

API for generating static map images

Developer Tools

README.md

Original

Docker Static Maps API 🗺️

Generate static map images via a REST API

Version Shield: Docker Pulls Shield: Docker Image Size

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.