Skip to content

docker-staticmaps

API Development

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

TypeScript Latest v0.10.0 · 1mo 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 for performance
  • Per‑IP rate limiting with optional API‑key authentication

Recent releases

View all 3 releases →
v0.10.0 New feature
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

v0.9.2 Bug fix

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

v0.9.1 Bug fix

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

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.

About

Stars
124
Forks
7
Languages
TypeScript CSS Dockerfile

Install & Platforms

Install via
docker

Beta — feedback welcome: [email protected]