As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Mapas estáticos **nota** Os mapas estáticos oferecem suporte somente aos estilos Padrão e Satélite. Para obter mais informações, consulte [AWS estilos e recursos do mapa](map-styles.md). Os mapas estáticos oferecem uma representação pré-renderizada de dados geográficos com a opção de sobrepor marcadores (ou pinos), rotas e áreas poligonais, conforme necessários para sua aplicação. O Mapa Estático permite gerar imagens de mapas estáticos (não interativos) com base em parâmetros personalizáveis e entradas de dados. Quando personaliza sobreposições, formas ou aplica estilos personalizados, o Mapa Estático permite criar visualizações de mapas que atendam a necessidades específicas, aprimorando a experiência do usuário final e comunicando informações geográficas de forma eficaz. O servidor personaliza as imagens do mapa solicitadas e as entrega ao cliente como arquivos JPEG. Você pode solicitar e gerar programaticamente imagens de mapas adaptadas às suas necessidades específicas. A *GetStaticMap API* gera uma imagem estática de um mapa com base em parâmetros específicos, como coordenadas centrais, caixas delimitadoras ou sobreposições. A API permite a personalização dos atributos e do estilo do mapa, permitindo o uso em aplicações web ou móveis sem a funcionalidade de mapa interativo. Para obter mais informações, consulte [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)a *Amazon Location Service API Reference*. Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar mapas estáticos](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html). ## Casos de uso comuns + **Mapas incorporados em aplicações web ou móveis:** imagens de mapas estáticos podem ser incorporadas de forma eficiente em sites ou aplicações móveis para fornecer visualizações de localizações, rotas ou pontos de interesse com mapas não interativos, reduzindo os tempos de carregamento e o uso de dados. Os exemplos incluem mecanismos de pesquisa (como o Yahoo) mostrando imagens de mapas com resultados de pesquisa para POIs. + **Detalhes de localização em e-mails:** imagens de mapas estáticos podem ser usadas para compartilhar informações de localização por e-mail para ajudar seus usuários finais a entender o contexto do e-mail. Por exemplo, aplicações de entrega de comida ou compartilhamento de viagens usam imagens de mapas estáticos para exibir locais de retirada/entrega, rotas ou áreas vizinhas em e-mails pós-viagem ou entrega contendo fatura e resumo. + **Materiais de marketing e documentos impressos:** imagens personalizadas de mapas estáticos podem ser incorporadas a livretos, folhetos ou outros materiais impressos, fornecendo representações visualmente atraentes de informações geográficas relevantes ao conteúdo. ## Sobre a solicitação A solicitação inclui parâmetros de URI opcionais, como`BoundedPositions`, `BoundingBox` e `Center`, entre outros, para definir a área visível e as sobreposições do mapa. Os parâmetros `Height` e `Width` são necessários para definir o tamanho da imagem. Para saber mais, consulte [Personalizar mapas estáticos](customizing-static-maps.md) e [Sobreposição no mapa estático](overlaying-static-map.md). + `BoundedPositions`: coordenadas a serem incluídas na imagem. + `BoundingBox`: coordenadas que definem as bordas sudoeste e nordeste do mapa. + `Height`: especifica a altura da imagem. + `Width`: especifica a largura da imagem. + `GeoJsonOverlay`: um objeto GeoJSON válido para adicionar sobreposições. ## Sobre a resposta A resposta contém cabeçalhos como `CacheControl`, `ContentType` e `ETag`, e retorna o mapa estático como um blob binário no formato JPEG ou PNG. Os cabeçalhos fornecem metadados como controle de cache, tipo de conteúdo e versão para imagens estáticas. + `CacheControl`: especifica as configurações de cache para a imagem do mapa. + `ContentType`: indica o formato da imagem do mapa (JPEG ou PNG). + `ETag`: um identificador para a versão da imagem estática do mapa. + `Blob`: representa a imagem do mapa no formato JPEG ou PNG. # Personalizar mapas estáticos **nota** Os mapas estáticos permitem apenas o estilo Satélite. Para obter mais informações, consulte [AWS estilos e recursos do mapa](map-styles.md). Esta seção é uma visão geral de como personalizar mapas estáticos gerados usando o Amazon Location Service. Ela abrange vários recursos, como ajustar a posição, o tamanho, o idioma, a escala, as sobreposições e a atribuição do mapa para que você adapte o mapa do seu jeito. Para obter mais informações, consulte [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)a *Amazon Location Service API Reference*. ## Position A posição permite definir o centro e os limites do mapa. Você pode controlar o foco do mapa definindo as coordenadas centrais, uma caixa delimitadora ou usando um nível de zoom para determinar a área de exibição. Para saber como funciona, consulte [Como obter um mapa estático de uma posição específica](get-static-map-specific-position.md). + `Center`: define o ponto central do mapa usando coordenadas de longitude e latitude. + `Radius`: especifica o raio (distância do centro) que será exibido no mapa estático. + `Bounding Box`: define uma área retangular do mapa que é estipulada por meio das coordenadas dos cantos superior esquerdo e inferior direito. + `Zoom`: controla o nível do zoom do mapa. Níveis de zoom mais altos mostram mais detalhes em uma área menor, enquanto níveis mais baixos mostram menos detalhes em uma área maior. ## Dimensão e qualidade Para personalizar o tamanho e a qualidade visual do mapa estático, basta definir suas dimensões (altura e largura) e adicionar preenchimento para melhor exibição de marcadores e outros elementos. Para saber como funciona, consulte [Como obter um mapa estático de uma dimensão específica](get-static-map-specific-dimension.md). + `Height and Width`: especifica o tamanho da imagem estática do mapa definindo sua altura e largura em pixels. + `Padding`: adiciona espaço extra ao redor das bordas do mapa, o que possibilita melhor visualização ao colocar marcadores, linhas ou formas. ## Escala A escala fornece controle sobre a escala do mapa e define as unidades (quilômetros, milhas) para medir distâncias. É útil para representar com precisão as relações de tamanho e distância do mapa. Para saber como funciona, consulte [Como adicionar escala para um mapa estático](add-scale-static-map.md). + `Scale Unit`: define as unidades da barra de escala do mapa (por exemplo, quilômetros ou milhas), permitindo que os usuários avaliem com precisão as distâncias no mapa. ## sobreposição Você pode adicionar marcadores, linhas para mostrar rotas, polígonos para mostrar áreas e muito mais. Para saber como funciona, consulte [Como adicionar um marcador a um mapa estático](add-marker-static-map.md), [Como adicionar uma linha a um mapa estático](how-to-add-line-static.md) ou[Como adicionar uma rota a um mapa estático](how-to-add-route.md). # Sobreposição no mapa estático Esta seção explica como sobrepor informações adicionais em mapas estáticos usando o Amazon Location Service. Você pode personalizar seus mapas estáticos adicionando vários atributos geográficos, como pontos, linhas e polígonos, para aprimorar a representação visual do mapa. O Amazon Location Service oferece suporte a vários formatos, incluindo GeoJSON e um formato de sobreposição compacto, para fornecer formas flexíveis e eficientes de adicionar sobreposições. Para obter mais informações, consulte [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html)a *Amazon Location Service API Reference*. ## Com GeoJSON O GeoJSON é um formato versátil que permite sobrepor dados personalizados em mapas estáticos. Quando define atributos geográficos, como pontos, linhas e polígonos, você pode aprimorar a representação visual de seus mapas, fornecendo um contexto valioso para os usuários. O GeoJSON é amplamente suportado e oferece flexibilidade quando se trata de estilizar e personalizar sobreposições de mapas, tornando-o um formato ideal para exibir regiões, traçar rotas ou mostrar relações espaciais. Com o Amazon Location Service, você pode aproveitar o GeoJSON para adicionar atributos dinâmicos baseados em localização diretamente em seus mapas estáticos. Isso permite que você crie sobreposições altamente personalizáveis que podem ser adaptadas para atender às suas necessidades comerciais específicas. O GeoJSON suporta vários tipos de geometria, incluindo `Point`, `LineString`, `Polygon` e `MultiPolygon`, permitindo que você exiba uma ampla variedade de atributos, desde marcadores e rotas até representações de áreas complexas. ## Cores Quando estilizar os atributos do GeoJSON, você tem flexibilidade na definição de cores. Você pode especificar cores usando formatos diferentes, como valores hexadecimais (como \$1ff0000 para vermelho) ou com transparência alfa (como \$1ff000080 para vermelho semitransparente). Isso garante que suas sobreposições possam ser visualmente consistentes com o estilo do mapa. Se nenhuma cor for especificada, a cor padrão para o estilo de mapa selecionado será aplicada. ## Ordem de desenho As sobreposições personalizadas são desenhadas em uma ordem específica para manter a clareza e evitar confusão visual. No Amazon Location Service, atributos de sobreposição, como polígonos, linhas e pontos, aparecerão acima do mapa base, mas abaixo dos rótulos do mapa. A ordem do desenho prioriza primeiro os polígonos, seguidos pelas linhas e depois pelos pontos ou marcadores. ## Unidades de medida Para propriedades como `width` e `outline-width`, você pode usar unidades de medida diferentes para especificar o tamanho, incluindo pixels (px), metros (m), quilômetros (km), milhas (mi) e porcentagens (%). A unidade percentual ajusta a propriedade em relação a um valor padrão, oferecendo mais flexibilidade no estilo de suas sobreposições. ## Tipos de geometria O Amazon Location Service oferece suporte a vários tipos de geometria GeoJSON, como `Point`, `LineString`, `Polygon` e `MultiPolygon`. Cada tipo de geometria pode ser estilizado e ajustado usando o objeto de propriedades no GeoJSON, permitindo uma ampla personalização de marcadores, rotas e áreas em seu mapa. ## Com sobreposição compacta **nota** A sobreposição compacta suporta os tipos de geometria: ponto, linha e polígono a seguir. Não há suporte para `multiPoint`, `multiLine` ou `multiPolgyon`. A opção de sobreposição compacta permite que você exiba com eficiência várias geometrias em um mapa estático usando um único parâmetro de consulta. Essa abordagem simplificada simplifica o formato da solicitação e reduz o tamanho da solicitação, facilitando a transmissão de dados de sobreposição. Os clientes podem inserir vários tipos de geometria e suas propriedades de estilo correspondentes em um parâmetro de consulta, e o Amazon Location Service cuidará do trabalho pesado analisando e renderizando a sobreposição conforme especificado. Quando for usar o formato de sobreposição compacto, lembre-se de que há limites no tamanho do URL da solicitação. Embora o Amazon Location Service otimize a consulta, certifique-se de que sua solicitação permaneça dentro de limites razoáveis, especialmente quando for lidar com várias geometrias e suas propriedades associadas. ## Formato O formato de sobreposição compacto é estruturado da seguinte forma: `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...` Cada tipo de geometria é definido junto com as propriedades de estilo dela. Várias geometrias são separadas por um operador pipe (\$1) e as propriedades de cada geometria são separadas usando-se ponto e vírgula. ## Tipos de geometria compatíveis O Amazon Location Service oferece suporte a vários tipos de geometria, incluindo `Point`, `MultiPoint`, `LineString`, `Polygon` e `MultiPolygon`. Esses tipos de geometria podem ser combinados e estilizados dentro do mesmo parâmetro de consulta usando-se o formato de sobreposição compacto. ## Propriedades de estilo Cada geometria pode ser personalizada usando-se várias propriedades de estilo, como cor, cor do contorno, tamanho e muito mais. Essas propriedades permitem que você controle a aparência de cada geometria no mapa, garantindo que a sobreposição esteja alinhada às suas necessidades comerciais.