Repolode
Enviar
dietrichmax

dietrichmax/docker-staticmaps

API REST autoalojable que genera imágenes de mapas estáticos con marcadores, polígonos, círculos, polilíneas y superposiciones de texto.

Alternativa open source a:Google Static Maps APIMapbox Static Images API

Ver en GitHubSitio web
Estrellas
130
Forks
8
Issues abiertos
2
Último commit
hace 23 horas

¿Qué es?

Docker Static Maps API es un servicio autoalojable que genera imágenes de mapas estáticos mediante un endpoint REST. Quien hace la solicitud especifica el tamaño, el centro, el nivel de zoom y el mapa base en una cadena de consulta, y puede añadir marcadores, polígonos, círculos, polilíneas y superposiciones de texto a la imagen generada.

Admite varios mapas base, como OpenStreetMap, Esri y Carto, además de servidores de teselas personalizados. También ofrece una superposición opcional de sombreado del relieve basada en teselas DEM ráster codificadas en Terrarium. Las teselas y las imágenes generadas se almacenan en caché, y la API aplica límites de solicitudes por IP, con autenticación opcional mediante API key.

El servicio se ejecuta como un contenedor Docker en el puerto 3000 e incluye un entorno interactivo en el navegador para probar solicitudes.

Funciones clave

  • 01Genera mapas estáticos con marcadores, polígonos, círculos, polilíneas y superposiciones de texto
  • 02Admite mapas base de OpenStreetMap, Esri y Carto, además de servidores de teselas personalizados
  • 03Ofrece una superposición opcional de sombreado del relieve a partir de teselas DEM codificadas en Terrarium
  • 04Almacena en caché las teselas y las imágenes generadas
  • 05Aplica límites de solicitudes por IP y ofrece autenticación opcional mediante API key
  • 06Se distribuye como una imagen Docker e incluye un entorno interactivo en el navegador

Casos de uso

  • Incorporar vistas previas de mapas en correos electrónicos, informes o notificaciones sin cargar un mapa JavaScript
  • Generar imágenes de ubicaciones para paneles o páginas renderizadas en el servidor
  • Crear miniaturas de mapas para anuncios que muestren una ruta, una zona o un conjunto de puntos
  • Ejecutar un servicio privado de mapas estáticos en una infraestructura propia

Inicio rápido

  1. 1

    Ejecuta la API con Docker

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

    Solicita una imagen de mapa de ejemplo

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

    Abre el entorno interactivo en un navegador

Antes de usarlo

  • El código fuente está bajo la licencia AGPL-3.0+, que impone estrictos requisitos de copyleft si lo modificas y lo alojas.

En colecciones

Apps autoalojadas

Temas

#static-maps#map-api#docker#self-hosted#openstreetmap#rest-api#api

Preguntas frecuentes

¿Qué es docker-staticmaps?
API REST autoalojable que genera imágenes de mapas estáticos con marcadores, polígonos, círculos, polilíneas y superposiciones de texto. Docker Static Maps API es un servicio autoalojable que genera imágenes de mapas estáticos mediante un endpoint REST. Quien hace la solicitud especifica el tamaño, el centro, el nivel de zoom y el mapa base en una cadena de consulta, y puede añadir marcadores, polígonos, círculos, polilíneas y superposiciones de texto a la imagen generada.
¿docker-staticmaps es gratuito? ¿Qué licencia tiene?
docker-staticmaps es open source bajo la licencia Other. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿docker-staticmaps sigue mantenido?
Mantenimiento activo. El último commit de docker-staticmaps fue el 6 nov 2026.
¿Para qué puedo usar docker-staticmaps?
Incorporar vistas previas de mapas en correos electrónicos, informes o notificaciones sin cargar un mapa JavaScript Generar imágenes de ubicaciones para paneles o páginas renderizadas en el servidor Crear miniaturas de mapas para anuncios que muestren una ruta, una zona o un conjunto de puntos Ejecutar un servicio privado de mapas estáticos en una infraestructura propia
¿Cómo se instala docker-staticmaps?
Ejecuta la API con Docker: docker run -p '3000:3000/tcp' mxdcodes/docker-staticmaps:latest Solicita una imagen de mapa de ejemplo: curl "http://localhost:3000/api/staticmaps?width=1000&height=1000&center=-18.2871,147.6992&zoom=9&basemap=satellite" Abre el entorno interactivo en un navegador
¿Dónde consigo docker-staticmaps?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/dietrichmax/docker-staticmaps

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados