dietrichmax/docker-staticmaps

Что это?

Ключевые возможности

• 01Добавляет на статичные карты маркеры, полигоны, окружности, линии и текстовые наложения
• 02Поддерживает базовые карты OpenStreetMap, Esri и Carto, а также собственные серверы тайлов
• 03Позволяет включить слой затенения рельефа на основе тайлов DEM в формате Terrarium
• 04Кэширует тайлы и созданные изображения
• 05Ограничивает частоту запросов с одного IP-адреса и при необходимости поддерживает аутентификацию по API key
• 06Поставляется в виде Docker-образа с браузерной площадкой

Сценарии использования

• Встраивание карт-превью в письма, отчёты и уведомления без загрузки JavaScript-карты
• Создание изображений с местоположением для дашбордов и страниц, отрисовываемых на сервере
• Создание миниатюр карт для объявлений с маршрутом, областью или набором точек
• Запуск собственного сервиса статичных карт на своей инфраструктуре

Быстрый старт

1. 1

   Запустите API с помощью Docker

   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+, которая устанавливает строгие требования копилефта, если вы изменяете и размещаете его.

В подборках

Темы

Частые вопросы

Что такое docker-staticmaps?

Самостоятельно размещаемый REST API для создания статичных картинок карт с маркерами, полигонами, окружностями, линиями и текстовыми наложениями. Docker Static Maps API — сервис, который можно разместить самостоятельно и который генерирует статичные изображения карт через REST endpoint. В запросе указывают размер, центр, масштаб и базовую карту, а также могут добавлять на изображение маркеры, полигоны, окружности, линии и текстовые наложения.

docker-staticmaps можно использовать бесплатно? Какая у него лицензия?

docker-staticmaps распространяется с открытым исходным кодом под лицензией Other. Перед использованием в коммерческих продуктах проверьте условия лицензии.

docker-staticmaps всё ещё поддерживается?

Активно поддерживается. Последний коммит в docker-staticmaps — 6 нояб. 2026 г..

Для чего можно использовать docker-staticmaps?

Встраивание карт-превью в письма, отчёты и уведомления без загрузки JavaScript-карты Создание изображений с местоположением для дашбордов и страниц, отрисовываемых на сервере Создание миниатюр карт для объявлений с маршрутом, областью или набором точек Запуск собственного сервиса статичных карт на своей инфраструктуре

Как установить docker-staticmaps?

Запустите API с помощью Docker: 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