Mapas estáticos
nota
Los mapas estáticos solo admiten el estilo satélite. Para obtener más información, consulte Estilos y personalización de mapas de AWS.
Los mapas estáticos ofrecen una representación prerenderizada de datos geográficos con la opción de superponer marcadores (o pines), rutas y áreas poligonales, según sea necesario para la aplicación. El mapa estático le permite generar imágenes de mapas estáticas (no interactivas) basadas en parámetros personalizables y entradas de datos. Al personalizar las superposiciones, las formas o la aplicación de estilos personalizados, el mapa estático le permite crear visualizaciones de mapas que satisfagan necesidades específicas, lo que mejora la experiencia del usuario final y comunica la información geográfica de forma eficaz. El servidor personaliza las imágenes de mapas solicitadas y las entrega al cliente como archivos JPEG. Puede solicitar y generar imágenes de mapas mediante programación que se adapten a sus requisitos específicos.
La API de GetStaticMap genera una imagen estática de un mapa en función de parámetros específicos, como las coordenadas centrales, los cuadros delimitadores o las superposiciones. La API permite personalizar las características y el estilo del mapa, lo que permite su uso en aplicaciones web o móviles sin la funcionalidad de mapas interactivos.
Para obtener más información, consulte GetStaticMap en la Referencia de la API de Amazon Location Service.
Para ver ejemplos de solicitudes, respuestas, cURL y comandos de la CLI para esta API, consulte Cómo usar mapas estáticos.
Casos de uso comunes
-
Mapas incrustados en aplicaciones web o móviles: las imágenes de mapas estáticos se pueden incrustar de manera eficiente en sitios web o aplicaciones móviles para proporcionar visualizaciones de ubicaciones, rutas o puntos de interés con mapas no interactivos, lo que reduce los tiempos de carga y el uso de datos. Algunos ejemplos son los motores de búsqueda (como Yahoo) que muestran imágenes de mapas con resultados de búsqueda para POI.
-
Detalles de ubicación en los correos electrónicos: las imágenes de mapas estáticos se pueden utilizar para compartir información de ubicación por correo electrónico y ayudar a los usuarios finales a entender el contexto del correo electrónico. Por ejemplo, las aplicaciones de entrega de comida a domicilio o de transporte compartido utilizan imágenes de mapas estáticas para mostrar los lugares de recogida o devolución, las rutas o las áreas circundantes en los correos electrónicos posteriores al viaje o a la entrega que contienen la factura y el resumen.
-
Materiales de marketing y documentos impresos: se pueden incorporar imágenes de mapas estáticos personalizados a folletos, volantes u otros materiales impresos, lo que proporciona representaciones visualmente atractivas de la información geográfica relevante para el contenido.
Explicación de la solicitud
La solicitud incluye parámetros de URI opcionales, como BoundedPositions, BoundingBox y Center, entre otros, para definir el área visible y las superposiciones del mapa. Los parámetros Height y Width son necesarios para definir el tamaño de la imagen. Para obtener más información, consulte Personalización de mapas estáticos y Superposición en el mapa estático.
-
BoundedPositions: coordenadas que se van a incluir en la imagen. -
BoundingBox: coordenadas que definen los bordes suroeste y noreste del mapa. -
Height: especifica la altura de la imagen. -
Width: especifica la anchura de la imagen. -
GeoJsonOverlay: un objeto GeoJSON válido para agregar superposiciones.
Explicación de la respuesta
La respuesta contiene encabezados comoCacheControl, ContentType y ETag, y devuelve el mapa estático como un blob binario en formato JPEG o PNG. Los encabezados proporcionan metadatos como el control de la caché, el tipo de contenido y la versión de las imágenes estáticas.
-
CacheControl: especifica las configuraciones de almacenamiento en caché para la imagen del mapa. -
ContentType: indica el formato de la imagen del mapa (JPEG o PNG). -
ETag: un identificador de la versión de la imagen del mapa estático. -
Blob: representa la imagen del mapa en formato PNG o JPEG.
