dietrichmax/docker-staticmaps

O que é?

Recursos principais

• 01Renderiza marcadores, polígonos, círculos, polilinhas e sobreposições de texto em mapas estáticos
• 02Oferece mapas-base OpenStreetMap, Esri e Carto, além de servidores de tiles personalizados
• 03Disponibiliza uma sobreposição opcional de relevo sombreado a partir de tiles DEM codificados em Terrarium
• 04Armazena em cache tiles e imagens geradas
• 05Aplica limitação de requisições por IP e autenticação opcional por chave de API
• 06É distribuído como uma imagem Docker com um playground no navegador

Casos de uso

• Incorporar prévias de mapas em e-mails, relatórios ou notificações sem carregar um mapa JavaScript
• Gerar imagens de localização para dashboards ou páginas renderizadas no servidor
• Criar miniaturas de mapas para anúncios que exibem uma rota, uma área ou um conjunto de pontos
• Executar um serviço privado de mapas estáticos na sua própria infraestrutura

Início rápido

1. 1

   Execute a API com Docker

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

   Solicite uma imagem de mapa de exemplo

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

   Abra o playground interativo em um navegador

Antes de usar

• !O código-fonte está licenciado sob AGPL-3.0+, que impõe requisitos rigorosos de copyleft se você modificá-lo e hospedá-lo.

Em coleções

Tópicos

Perguntas frequentes

O que é docker-staticmaps?

API REST auto-hospedável que renderiza imagens de mapas estáticos com marcadores, polígonos, círculos, polilinhas e sobreposições de texto. A Docker Static Maps API é um serviço auto-hospedável que gera imagens de mapas estáticos por meio de um endpoint REST. Quem faz as chamadas especifica o tamanho, o centro, o zoom e o mapa-base em uma query string, e pode adicionar marcadores, polígonos, círculos, polilinhas e sobreposições de texto à imagem renderizada.

docker-staticmaps é gratuito? Qual é a licença?

docker-staticmaps é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.

docker-staticmaps ainda é mantido?

Manutenção ativa. O último commit de docker-staticmaps foi em 6 de nov. de 2026.

Para que posso usar docker-staticmaps?

Incorporar prévias de mapas em e-mails, relatórios ou notificações sem carregar um mapa JavaScript Gerar imagens de localização para dashboards ou páginas renderizadas no servidor Criar miniaturas de mapas para anúncios que exibem uma rota, uma área ou um conjunto de pontos Executar um serviço privado de mapas estáticos na sua própria infraestrutura

Como instalar docker-staticmaps?

Execute a API com Docker: docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest Solicite uma imagem de mapa de exemplo: curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite" Abra o playground interativo em um navegador

Onde consigo docker-staticmaps?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dietrichmax/docker-staticmaps