Mapas estáticos
nota
Os mapas estáticos fornecem suporte apenas para o estilo Satélite. Para obter mais informações, consulte Estilos e personalização de mapas da AWS.
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 seu aplicativo. 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 API GetStaticMap 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 aplicativos web ou móveis sem a funcionalidade de mapa interativo.
Para obter mais informações, consulte GetStaticMap na Referência de API do Amazon Location Service.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar mapas estáticos.
Casos de uso comuns
-
Mapas incorporados em aplicativos web ou móveis: imagens de mapas estáticos podem ser incorporadas de forma eficiente em sites ou aplicativos 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, aplicativos 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, comoBoundedPositions, 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 e Sobreposição no mapa estático.
-
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.
