Docker Static Maps API

A containerized web version for staticmaps with express.

Usage

To get a static map from the endpoint /staticmaps several prameters have to be provided.

• center - Center coordinates of the map in the format lon, lat
• zoom - Set the zoom level for the map.
• width - default 300 - Width in pixels of the final image
• height - default 300 - Height in pixels of the final image
• format - default png (e.g. png, jpg or webp)

For different basemaps docker-staticmaps is using exisiting tile-services from various providers. Be sure to check their Terms of Use for your use case or use a custom tileserver with the tileUrl parameter!

• basemap - default "osm" - Select the basemap
  • osm - default - Open Street Map
  • streets - Default Esri street basemap
  • satellite - Esri's satellite basemap
  • hybrid - Satellite basemap with labels
  • topo - Esri topographic map
  • gray - Esri gray canvas with labels
  • gray-background - Esri gray canvas without labels
  • oceans - Esri ocean basemap
  • national-geographic - National Geographic basemap
  • otm - OpenTopoMap
  • stamen-toner - Stamen Toner black and white map with labels
  • stamen-toner-background - Stamen Toner map without labels
  • stamen-toner-lite - Stamen Toner Light with labels
  • stamen-terrain - Stamen Terrain with labels
  • stamen-terrain-background - Stamen Terrain without labels
  • stamen-watercolor - Stamen Watercolor
  • carto-light - Carto Free usage for up to 75,000 mapviews per month, non-commercial services only.
  • carto-dark - Carto Free usage for up to 75,000 mapviews per month, non-commercial services only.
  • carto-voyager - Carto Free usage for up to 75,000 mapviews per month, non-commercial services only.
  • custom - Pass through the tile URL using parameter tileurl

Deployment

with Docker

docker run -d  --name='static-maps-api' -p '3003:3000/tcp' 'mxdcodes/docker-staticmaps:latest'

with Node.js

git clone https://github.com/dietrichmax/docker-staticmaps
npm i
npm run start

Example requests

• http://localhost:3000/staticmaps?width=300&height=300&center=-119.49280,37.81084&zoom=9&format=png

• http://localhost:3000/staticmaps?width=500&height=500&center=-73.99515,40.76761&zoom=10&format=webp&basemap=carto-voyager

• http://localhost:3000/staticmaps?width=500&height=500&center=-73.99515,40.76761&zoom=10&format=png&tileUrl=https://server.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer/tile/{z}/{y}/{x}