

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Mapas estáticos
<a name="static-maps"></a>

**nota**  
Los mapas estáticos solo admiten los estilos Estándar y Satélite. Para obtener más información, consulte [AWS estilos y características del mapa](map-styles.md).

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 *GetStaticMap API* 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, consulta [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)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](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html).

## Casos de uso comunes
<a name="static-maps-use-cases"></a>
+ **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 los resultados de búsqueda correspondientes POIs.
+ **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
<a name="static-maps-understanding-request"></a>

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](customizing-static-maps.md) y [Superposición en el mapa estático](overlaying-static-map.md).
+ `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
<a name="static-maps-understanding-response"></a>

La respuesta contiene encabezados como`CacheControl`, `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.