dietrichmax/docker-staticmaps

这是什么？

核心功能

• 01在静态地图上绘制标记、多边形、圆形、折线和文字
• 02支持 OpenStreetMap、Esri、Carto 底图以及自定义瓦片服务
• 03提供基于 Terrarium 编码 DEM 瓦片的可选山体阴影图层
• 04缓存瓦片和生成的图片
• 05支持按 IP 限流和可选的 API Key 鉴权
• 06以 Docker 镜像发布，并附带浏览器端测试界面

适用场景

• 在邮件、报告或通知中嵌入地图预览，无需加载 JavaScript 地图
• 为仪表盘或服务端渲染页面生成位置图片
• 为展示路线、区域或一组点位的列表生成地图缩略图
• 在自有基础设施上部署私有的静态地图服务

快速上手

1. 1

   使用 Docker 运行 API

   docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest
2. 2

   请求一张示例地图图片

   curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite"
3. 3

   在浏览器中打开交互式演示页面

使用前须知

• !源代码采用 AGPL-3.0+ 许可证，如果你修改并对外提供服务，需要遵守较强的 Copyleft 要求。

收录于专题

标签

常见问题

docker-staticmaps 是什么？

可自托管的 REST API，用于生成带标记、多边形、圆形、折线和文字叠加的静态地图图片。 Docker Static Maps API 是一个可自托管的服务，通过 REST 接口生成静态地图图片。调用方可以在查询参数中指定尺寸、中心点、缩放级别和底图，并在图上叠加标记、多边形、圆形、折线和文字。

docker-staticmaps 可以免费使用吗？用的什么许可证？

docker-staticmaps 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

docker-staticmaps 还在维护吗？

活跃维护中。docker-staticmaps 最近一次提交是在 2026年11月6日。

docker-staticmaps 适合用来做什么？

在邮件、报告或通知中嵌入地图预览，无需加载 JavaScript 地图 为仪表盘或服务端渲染页面生成位置图片 为展示路线、区域或一组点位的列表生成地图缩略图 在自有基础设施上部署私有的静态地图服务

docker-staticmaps 怎么安装和运行？

使用 Docker 运行 API: docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest 请求一张示例地图图片: curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite" 在浏览器中打开交互式演示页面

在哪里获取 docker-staticmaps？

源代码和安装说明在 GitHub 上：https://github.com/dietrichmax/docker-staticmaps