docker-staticmaps

API Development

Self-hostable REST API for generating static map images with markers, overlays, caching, rate limiting, and optional API‑key auth

Track releases GitHub Website

TypeScript Latest v0.10.2 · 23d ago Security brief →

Features

Render maps with markers, polygons, circles, polylines and text overlays
Support multiple basemaps (OpenStreetMap, Esri, Carto) plus custom tile servers
Optional hillshade overlay using Terrarium‑encoded DEM tiles
Tile and image caching to improve performance
Per‑IP rate limiting and optional API‑key authentication

Recent releases

View all 5 releases →

No immediate action

v0.10.2 Mixed 23d

Security policy + Docker hardening + deps updates

Open

Review required

v0.10.1 Security relevant 1mo

Dependencies

CVE fix + smaller image

Open

v0.10.0 New feature 2mo

Notable features

`hillshade=true` query parameter adds server‑side shaded‑relief overlay with configurable tile source via `HILLSHADE_TILE_URL`

Full changelog

New

🔹Add hillshade=true query parameter — composites a shaded-relief overlay on top of the basemap, rendered server-side from Terrarium-encoded raster-DEM tiles. Tile source defaults to the public AWS Open Data Mapzen Terrain Tiles endpoint and can be overridden via the HILLSHADE_TILE_URL env var. Short-form attribution is appended automatically.

Example request:

http://localhost:3000/api/staticmaps?width=600&height=400&center=46.5,11.3&zoom=10&basemap=osm&hillshade=true

Docs: https://dietrichmax.github.io/docker-staticmaps/api-reference/hillshade

Tooling

🔹 Bump dependencies to latest: TypeScript 6, @types/node 25, webpack-cli 7, canvas 3.2.3, express-rate-limit 8.4.1. tsconfig updated for TS 6.

Documentation

🔹New Hillshade API reference page with example screenshot.
🔹parameters.md and configuration.md updated.

Dependencies

🔹chore(deps): bump protocol-buffers-schema from 3.6.0 to 3.6.1 (#106) by @dependabot
🔹chore(deps): bump follow-redirects from 1.15.11 to 1.16.0 in /docs (#105) by @dependabot
🔹chore(deps): bump lodash from 4.17.23 to 4.18.1 in /docs (#104) by @dependabot
🔹chore(deps): bump picomatch from 2.3.1 to 2.3.2 in /docs (#98) by @dependabot
🔹chore(deps): bump node-forge from 1.3.2 to 1.4.0 in /docs (#101) by @dependabot
🔹chore(deps): bump minimatch and serve-handler in /docs (#94) by @dependabot
🔹chore(deps): bump brace-expansion from 1.1.12 to 1.1.13 in /docs (#103) by @dependabot
🔹chore(deps): bump path-to-regexp from 8.3.0 to 8.4.0 (#100) by @dependabot
🔹chore(deps-dev): bump handlebars from 4.7.8 to 4.7.9 (#99) by @dependabot
🔹chore(deps): bump path-to-regexp from 0.1.12 to 0.1.13 in /docs (#102) by @dependabot
🔹chore(deps): bump svgo from 3.3.2 to 3.3.3 in /docs (#96) by @dependabot

Full Changelog: https://github.com/dietrichmax/docker-staticmaps/compare/v0.9.0...v0.10.0

View release on GitHub

v0.9.2 Bug fix 4mo

Fixed a coordinate swapping bug in geodesic polyline rendering and upgraded several build and runtime dependencies.

View release on GitHub

v0.9.1 Bug fix 5mo

Fixed crashes caused by JSON POST requests for map attribution and border parameters and cleaned up unused code while updating dependencies to improve stability.

View release on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.