Geocodificação - Amazon Location Service
Casos de usoSobre a solicitaçãoSobre a resposta

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á.

Geocodificação

A geocodificação transforma endereços textuais ou nomes de lugares em coordenadas geográficas, juntamente com componentes de endereço detalhados e informações adicionais. Essa API permite consultas flexíveis, incluindo texto de formato livre e consultas estruturadas com nomes de ruas, códigos postais e regiões. Os recursos opcionais incluem dados de fuso horário e ajustes de visão política.

nota

Os resultados armazenados geram preços de armazenamento mais altos. Use o parâmetro IntendedUse para indicar uso único ou armazenamento. Consulte Preços de locais para entender as implicações de custo dos resultados armazenados.

Para obter mais informações, consulte Geocodificação na Referência de API do Amazon Location Service.

Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar a geocodificação.

Casos de uso

  • Adicionar dados complementares aos endereços dos clientes: melhore os registros de endereços incluindo códigos postais e coordenadas, e utilizando armazenamento persistente para embasar decisões de negócios e marketing informadas.

  • Padronização de dados de endereço: aplique geocodificação em pipelines de dados ou processos em lote para padronizar os dados de endereço, utilizando armazenamento persistente para referência contínua.

  • Determinar fusos horários: identifique o fuso horário de cidades ou endereços para fornecer registros de data e hora precisos para aplicações como viagens, agendamento e faturamento.

Sobre a solicitação

A solicitação aceita parâmetros opcionais, como AdditionalFeatures, BiasPosition e Filter, para refinar os resultados da pesquisa. Opções adicionais, como Language, MaxResults e PoliticalView, personalizam ainda mais a resposta. O parâmetro necessário é Query, que pode ser fornecido como texto de formato livre ou estruturado como QueryComponents. Para obter mais informações, consulte a Referência da API de Geocodificação.

A solicitação inclui os seguintes parâmetros principais:

Autenticação

Para autenticação, o parâmetro Key será opcional se outros métodos estiverem em uso.

  • Key: parâmetro opcional para autenticação.

Para obter mais informações, consulte . Autenticação com o Amazon Location Service

Consulta e desvios

Parâmetros usados para desvios de consulta e geografia em relação aos resultados.

  • QueryText: consulta de texto em formato livre para pesquisar locais.

  • QueryComponents: componentes estruturados, como número de endereço, país, localidade ou código postal, para uma pesquisa precisa.

  • BiasPosition: posição geográfica para onde desviar os resultados da pesquisa.

Para obter mais informações, consulte . Consulta e desvios

Refinar resultados

Aplique filtros para refinar os resultados.

  • Filter: filtre para incluir países ou tipos de lugares específicos. Para obter mais informações, consulte Filtrar.

Internacionalização e localização

Especifique o idioma e aplique uma visão política para obter resultados adaptados.

  • Language: idioma para os resultados.

  • PoliticalView: aplica uma visão política que reflete reivindicações territoriais.

Para obter mais informações, consulte . Localização e internacionalização

Recursos adicionais do

Solicite informações adicionais, como detalhes do fuso horário.

  • AdditionalFeatures: opção para solicitar detalhes adicionais, como fuso horário. Para obter mais informações, consulte Recursos adicionais.

Sobre a resposta

A resposta fornece ResultItems, que contém dados de localização detalhados, como Address, PlaceId, Position e outros atributos relevantes. Recursos adicionais, como informações de TimeZone ou MatchScores para cada componente de consulta, também podem ser incluídos. Cada ResultItem representa uma localização correspondente ou um resultado de geocodificação com base nos parâmetros de solicitação especificados. Para obter mais detalhes, consulte a Referência da API de Geocodificação.

A resposta inclui os seguintes parâmetros principais:

Endereço e detalhes relacionados

Detalhes sobre o local retornado, incluindo componentes do endereço.

  • Address: endereço completo, incluindo detalhes do país, região, código postal e rua.

  • PostalCodeDetails: informações adicionais relacionadas aos códigos postais.

  • StreetComponents: detalhes da rua, incluindo nome e tipo básicos.

Tipos e categorias de locais

Informações sobre o tipo e a categoria do local retornado.

  • Categories: lista de categorias que descrevem o local, por exemplo, Restaurantes e Escolas.

  • PlaceType: especifica o tipo de local, como cidade, endereço ou região.

Análise de resultados

Pontuações que indicam o grau de correspondência entre os resultados e a consulta de entrada.

  • MatchScores: pontuações para associar a precisão.

    • Overall: mede até que ponto uma pesquisa de endereço corresponde à sua entrada, em uma escala de 0,0 a 1,0 (0% a 100%). Uma pontuação perfeita de 1,0 significa que todas as partes da sua pesquisa foram encontradas no banco de dados. É normal ver pontuações mais baixas ao incluir detalhes extras, como nomes de contato ou instruções de entrega. Isso naturalmente reduz a pontuação, mas não significa necessariamente que o endereço esteja errado.

    • Component Score: cada componente do endereço (como AddressNumber ou PostalCode) recebe uma pontuação individual em uma escala de 0,0 a 1,0 (0% a 100%). Essas pontuações indicam com que precisão cada parte do endereço corresponde ao resultado. Por exemplo, se a pontuação de AddressNumber, Street e PostalCode chegar perto de 1,0, você pode confiar na correspondência, mesmo que a pontuação geral seja menor por causa de outros detalhes da consulta.

    nota

    Quando não aparece pontuação para um componente específico (como Street), esse componente é considerado 0. Isso ajuda a identificar partes do endereço que podem precisar de verificação.

    Esse sistema de pontuação ajuda a equilibrar as correspondências exatas e a usabilidade prática ao lidar com pesquisas de endereços reais, que geralmente incluem informações extras.

Outros detalhes

Inclui informações adicionais relacionadas à localização, conforme necessário.

  • AccessPoints: coordenadas geográficas que representam pontos de acesso.

  • TimeZone: informações sobre fuso horário da localização.