IDERioja

El API de mapas estáticos es una interfaz que permite a los desarrolladores generar imágenes de mapas sin la necesidad de una interacción en tiempo real con un servidor de mapas. En lugar de cargar los datos del mapa dinámicamente según la interacción del usuario, este API permite la creación de imágenes de mapas pre-renderizadas a partir de datos geoespaciales.

Características y Funcionamiento:

1. Generación de Imágenes Estáticas: El API permite la generación de imágenes de mapas en formato PNG, JPEG u otros formatos de imagen estándar. Estas imágenes representan una vista fija del mapa en un momento específico, sin la capacidad de interactuar con ellas.
2. Personalización del Mapa: Los usuarios pueden personalizar varios aspectos del mapa estático, como el estilo del mapa, los elementos a mostrar, los colores, la escala y la ubicación geográfica. Esto permite adaptar la imagen del mapa según las necesidades específicas de cada aplicación o proyecto.
3. Parámetros de Solicitud: Los desarrolladores pueden especificar una serie de parámetros en la solicitud del API para definir la extensión geográfica del mapa, el nivel de zoom, el tamaño de la imagen y otras configuraciones relevantes. Estos parámetros determinan qué área del mundo se incluirá en la imagen del mapa y cómo se visualizará.
4. Eficiencia en el Servicio: El API está diseñado para generar imágenes de mapas estáticos de manera eficiente, incluso para conjuntos de datos geoespaciales grandes y complejos. Esto garantiza tiempos de respuesta rápidos y una experiencia de usuario fluida al visualizar mapas estáticos en aplicaciones y sitios web.
5. Integración Simple: La integración del API de mapas estáticos en aplicaciones web y sistemas existentes es sencilla y directa. Los desarrolladores pueden realizar solicitudes HTTP estándar al API para generar y obtener imágenes de mapas estáticos según sea necesario, lo que facilita la inclusión de mapas estáticos en diversos contextos y proyectos.

En resumen, el API de mapas estáticos proporciona una forma conveniente y eficiente de generar imágenes de mapas pre-renderizadas a partir de datos geoespaciales, lo que permite su integración en una amplia variedad de aplicaciones y proyectos sin la necesidad de una interacción en tiempo real con un servidor de mapas.

Documentación:

Puntos de acceso (endpoints):

• https://rts.larioja.org/{id-estilo}/static/{lon},{lat},{zoom}[@{bearing}[,{pitch}]]/{width}x{height}[@2x].{format} → basado en un punto central
• https://rts.larioja.org/{id-estilo}/static/{minx},{miny},{maxx},{maxy}/{width}x{height}[@2x].{format} → basado en un rectángulo o bounding box
• https://rts.larioja.org/{id-estilo}/static/auto/{width}x{height}[@2x].{format} → basado en parámetros

Parámetros (query parameters):

Todos los puntos de acceso soportan los siguientes parámetros:

• path - ((fill|stroke|width)\:[^\|]+\|)*(enc:.+|-?\d+(\.\d*)?,-?\d+(\.\d*)?(\|-?\d+(\.\d*)?,-?\d+(\.\d*)?)+)
  • pares de coordenadas separados por coma lng,lat y separados por pipe entre cada par de coordenadas
    • e.g. path=-2.44383,42.46506|-2.4445,42.46312|-2.4411,42.46226|-2.43990,42.46451|-2.43918,42.464087
  • con opciones (fillwidth)
    • e.g. path=stroke:yellow|width:2|fill:green|-2.44383,42.46506|-2.4445,42.46312|-2.4411,42.46226|-2.43990,42.46451|-2.43918,42.464087
  • se puede solicitar mútiples veces
• latlng - indica que las coordenadas están en orden invertido en lat,lng para paths y markers
• fill - color de de relleno para todos los paths (e.g. red, rgba(255,255,255,0.5), #0000ff)
• stroke - color de línea para todos los paths
• width - grosor de línea para todos los paths
• linecap - estilo de renderizado para la terminación de líneas (paths) - ver https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineCap
• linejoin - estilo de renderizado para las uniones de línea cuando la dirección cambia - ver https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/lineJoin
• border - color del borde opcional de los paths
• borderwidth - grosor del borde (por defecto 10% del ancho) para los paths
• marker - Marker en formato lng,lat|iconPath|option|option|...
  • se representará en la parte inferior central de la ubicación proporcionada
  • lng,lat e iconPath son obligatorias si se utilizan conjuntamente
  • iconPath puede ser un enlace a una imagen servida por http(s) o un nombre de imagen de los que hay disponibles
  • option debe cumplir con el formato optionName:optionValue y soporta los siguientes nombres
    • scale - factor de escala de la imagen
      • e.g. 0.5 - escala la imagen a la mitad de su tamaño
    • offset - desplazamiento de la imagen positivo o negativo en píxeles[offsetX],[offsetY]
      • e.g. 2,-4 - la imagen se mueve 2 píxeles hacia la derecha y 4 píxeles hacia arriba en relación a la ubicación proporcionada
  • e.g. 5.9,45.8|solid-marker.svg|scale:0.5|offset:2,-4
  • se puede solicitar mútiples veces
• padding - margen del mapael valor 0.1 significa "añade un 10% de margen a cada lado de la imagen"
• maxzoom - nivel de zoom máximo para el punto de acceso basado en parámetros, ya que no se provee un nivel de zoom, si no que se calcula automáticamente

Galería de estilos

Consultar la web: https://rts.larioja.org