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 **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 + **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 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 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. # Personalización de mapas estáticos **nota** Los mapas estáticos solo admiten el estilo satélite. Para obtener más información, consulte [AWS estilos y características del mapa](map-styles.md). En esta sección se proporciona información general sobre cómo personalizar mapas estáticos generados mediante Amazon Location Service. Abarca varias características, como el ajuste de la posición, el tamaño, el idioma, la escala, las superposiciones y la atribución del mapa, lo que le permite adaptar el mapa a sus requisitos específicos. 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*. ## Posición La posición le permite definir el centro y los límites del mapa. Puede controlar el enfoque del mapa configurando las coordenadas del centro, un cuadro delimitador o utilizando un nivel de zoom para determinar la cantidad de área que se mostrará. Para saber cómo funciona, consulte [Cómo obtener un mapa estático de una posición específica](get-static-map-specific-position.md). + `Center`: define el punto central del mapa mediante las coordenadas de longitud y latitud. + `Radius`: especifica el radio (distancia desde el centro) que se mostrará en el mapa estático. + `Bounding Box`: define un área rectangular del mapa, que se establece proporcionando las coordenadas de las esquinas superior izquierda e inferior derecha. + `Zoom`: controla el nivel de zoom del mapa. Los niveles de zoom más altos muestran más detalles en un área más pequeña, mientras que los niveles de zoom más bajos muestran menos detalles en un área más grande. ## Dimensión y calidad Puede personalizar el tamaño y la calidad visual del mapa estático definiendo sus dimensiones (altura y anchura) y agregando relleno para una mejor presentación de los marcadores y otros elementos. Para saber cómo funciona, consulte [Cómo obtener un mapa estático de una dimensión específica](get-static-map-specific-dimension.md). + `Height and Width`: especifica el tamaño de la imagen del mapa estático definiendo su altura y anchura en píxeles. + `Padding`: agrega espacio adicional alrededor de los bordes del mapa, lo que permite una mejor visualización al colocar marcadores, líneas o formas. ## Escalado La escala permite controlar la escala del mapa y define las unidades (kilómetros, millas) para medir las distancias. Esto resulta útil para representar con precisión las relaciones entre el tamaño y la distancia del mapa. Para saber cómo funciona, consulte [Cómo agregar una escala a un mapa estático](add-scale-static-map.md). + `Scale Unit`: define las unidades de la barra de escala del mapa (por ejemplo, kilómetros o millas), lo que permite a los usuarios medir con precisión las distancias en el mapa. ## Superposición Puede agregar marcadores, líneas para mostrar rutas, polígonos para mostrar áreas, etc. Para saber cómo funciona, consulte [Cómo agregar un marcador a un mapa estático](add-marker-static-map.md), [Cómo agregar una línea a un mapa estático](how-to-add-line-static.md) o [Cómo agregar una ruta a un mapa estático](how-to-add-route.md). # Superposición en el mapa estático En esta sección se explica cómo superponer información adicional en mapas estáticos mediante Amazon Location Service. Puede personalizar los mapas estáticos agregando varias características geográficas, como puntos, líneas y polígonos, para mejorar la representación visual del mapa. Amazon Location Service admite varios formatos, incluidos GeoJSON y un formato de superposición compacto, para ofrecer formas flexibles y eficaces de agregar superposiciones. 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*. ## Con GeoJSON GeoJSON es un formato versátil que permite superponer datos personalizados en mapas estáticos. Al definir características geográficas como puntos, líneas y polígonos, puede mejorar la representación visual de los mapas, lo que proporciona un contexto valioso para los usuarios. GeoJSON es ampliamente compatible y ofrece flexibilidad a la hora de diseñar y personalizar las superposiciones de mapas, lo que lo convierte en un formato ideal para mostrar regiones, trazar rutas o mostrar relaciones espaciales. Con Amazon Location Service, puede aprovechar GeoJSON para agregar características dinámicas basadas en la ubicación directamente a los mapas estáticos. Esto le permite crear superposiciones altamente personalizables que se pueden adaptar a las necesidades específicas de la empresa. GeoJSON admite varios tipos de geometría, incluidos `Point`, `LineString`, `Polygon` y `MultiPolygon`, lo que le permite mostrar una amplia gama de características, desde marcadores y rutas hasta representaciones de áreas complejas. ## Colores Al diseñar las características de GeoJSON, tiene flexibilidad para definir los colores. Puede especificar los colores utilizando diferentes formatos, como valores hexadecimales (como \$1ff0000 para el rojo) o con una transparencia alfa (como \$1ff000080 para el rojo semitransparente). Esto garantiza que las superposiciones sean visualmente coherentes con el estilo del mapa. Si no se especifica ningún color, se aplicará el color predeterminado para el estilo de mapa seleccionado. ## Orden de dibujo Las superposiciones personalizadas se dibujan en un orden específico para mantener la claridad y evitar el desorden visual. En Amazon Location Service, las características superpuestas, como polígonos, líneas y puntos, aparecerán sobre el mapa base, pero debajo de las etiquetas del mapa. El orden de dibujo prioriza primero los polígonos, seguidos de las líneas y, a continuación, de los puntos o marcadores. ## Unidades de medida Para propiedades como `width` y `outline-width`, puede usar diferentes unidades de medida para especificar el tamaño, incluidos píxeles (px), metros (m), kilómetros (km), millas (millas) y porcentajes (%). La unidad de porcentaje ajusta la propiedad en relación con un valor predeterminado, lo que proporciona más flexibilidad a la hora de diseñar las superposiciones. ## Tipos de geometría Amazon Location Service admite varios tipos de geometría de GeoJSON, como `Point`, `LineString`, `Polygon` y `MultiPolygon`. Cada tipo de geometría se puede diseñar y ajustar mediante el objeto de propiedades de GeoJSON, lo que permite una amplia personalización de los marcadores, las rutas y las áreas del mapa. ## Con superposición compacta **nota** La superposición compacta admite los siguientes tipos de geometría: punto, línea y polígono. No admite `multiPoint`, `multiLine` ni `multiPolgyon`. La opción de superposición compacta le permite mostrar de manera eficiente varias geometrías en un mapa estático mediante un único parámetro de consulta. Este enfoque simplificado simplifica el formato de la solicitud y reduce su tamaño, lo que facilita la transmisión de datos superpuestos. Los clientes pueden ingresar varios tipos de geometría y sus correspondientes propiedades de estilo en un parámetro de consulta, y Amazon Location Service se encargará del trabajo pesado analizando y renderizando la superposición según lo especificado. Al utilizar el formato de superposición compacta, tenga en cuenta que hay límites en el tamaño de la URL de la solicitud. Aunque Amazon Location Service optimiza la consulta, asegúrese de que la solicitud se mantenga dentro de límites razonables, especialmente cuando se trate de varias geometrías y sus propiedades asociadas. ## Formato El formato de superposición compacto se estructura de la siguiente manera: `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...` Cada tipo de geometría se define junto con sus propiedades de estilo. Las geometrías múltiples se separan mediante un operador de canalización (\$1) y las propiedades de cada geometría se separan mediante punto y coma. ## Tipos de geometría compatibles Amazon Location Service admite varios tipos de geometría, incluidos `Point`, `MultiPoint`, `LineString`, `Polygon` y `MultiPolygon`. Estos tipos de geometría se pueden combinar y diseñar dentro del mismo parámetro de consulta mediante el formato de superposición compacta. ## Propiedades de estilo Cada geometría se puede personalizar mediante varias propiedades de estilo, como el color, el color del contorno, el tamaño, etc. Estas propiedades le permiten controlar el aspecto de cada geometría en el mapa, lo que garantiza que la superposición se ajuste a los requisitos de la empresa.