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 reversa
O código geográfico reverso converte as coordenadas geográficas em um endereço ou local legível por humanos. Ele fornece componentes detalhados de endereço, tipo de local, categoria e informações de rua, com opções de filtragem com base no tipo de local para refinar os resultados. A API também pode incluir recursos adicionais, como informações de fuso horário e ajustes na visão política.
nota
Se os resultados forem armazenados, eles serão cobrados de acordo com o nível de preço de armazenamento mais alto. Use o IntendedUse parâmetro para especificar se os resultados são para uso único ou armazenamento. Consulte Preços de lugares para ver as implicações de custo associadas aos resultados armazenados.
Para obter mais informações, consulte ReverseGeocodea Amazon Location Service API Reference.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar o código geográfico reverso.
Casos de uso
-
Adicione dados complementares aos dados de posição do cliente: melhore os registros de dados de posição incluindo códigos postais, coordenadas e utilizando armazenamento persistente para apoiar decisões comerciais e de marketing informadas.
-
Padronização de dados de posição: aplique geocodificação em pipelines de dados ou processos em lote para padronizar os dados de posição, utilizando armazenamento persistente para referência contínua.
-
Determine os fusos horários: identifique o fuso horário das cidades ou endereços para fornecer registros de data e hora precisos para aplicações como viagens, agendamento e faturamento.
Entenda a solicitação
A solicitação da API Reverse Geocode aceita uma combinação de parâmetros obrigatórios e opcionais para personalizar os resultados. O parâmetro necessário QueryPosition (longitude e latitude) especifica as coordenadas para reverter a geocodificação. Os parâmetros opcionais incluem AdditionalFeatures dados extras, Filter refinar resultados e MaxResults limitar o número de resultados retornados. Opções adicionaisLanguage, comoPoliticalView, e IntendedUse permitem uma maior personalização. Para obter mais detalhes, consulte a Referência da API de Geocodificação Reversa.
A solicitação aceita os seguintes parâmetros principais:
- Autenticação
-
O
Keyparâmetro é opcional se outros métodos de autenticação forem usados.-
Key: parâmetro opcional para autenticação.
Para obter mais informações, consulte Autenticar com o Amazon Location Service.
-
- Consultas
-
Parâmetros usados para definir a localização geográfica e o raio de pesquisa.
-
QueryPosition: especifica a longitude e a latitude para a solicitação de geocodificação reversa. -
QueryRadius: define o raio de busca ao redor das coordenadas.
Para obter mais informações, consulte Consulta e distorção.
-
- Refinando os resultados
-
Aplique filtros para limitar os resultados da pesquisa a países ou tipos de lugares específicos.
-
Filter: filtre os resultados com base no tipo de país ou local.
Consulte mais detalhes em Filtrar.
-
- Internacionalização e localização
-
Opções para personalizar o idioma e aplicar uma visão política aos resultados.
-
Language: especifica o idioma dos resultados. -
PoliticalView: Aplica uma visão política que reflete reivindicações territoriais.
Para obter mais informações, consulte Localização e internacionalização.
-
- Características adicionais
-
Solicita dados extras, como informações de fuso horário.
-
AdditionalFeatures: opção para solicitar dados adicionais, como detalhes do fuso horário.
Para obter mais informações, consulte Recursos adicionais.
-
Entenda a resposta
A resposta da API Reverse Geocode fornece informações detalhadas sobre localizações nas coordenadas especificadas. A ResultItems matriz inclui uma lista de objetos de lugar, cada um contendo detalhes de endereço, categorias e posição geográfica. Dados adicionaisTimeZone, como,FoodTypes, e PostalCodeDetails oferecem mais contexto. A resposta também inclui informações da caixa delimitadora para mapeamento e a distância da posição da consulta. Para obter mais detalhes, consulte a Referência da API de Geocodificação Reversa.
A resposta inclui os seguintes dados principais:
- Endereço e detalhes relacionados
-
Informações detalhadas do endereço do local devolvido.
-
Address: informações completas de endereço, incluindo país, região, código postal e detalhes da rua. -
PostalCodeDetails: detalhes adicionais relacionados aos códigos postais, como classificações e autoridades postais. -
StreetComponents: Detalhes adicionais sobre a rua, incluindo nome e tipo base.
-
- Tipos e categorias de lugares
-
Descreve o tipo e a categoria do local devolvido.
-
Categories: Categorias que descrevem o local, como restaurantes ou escolas. -
PlaceType: especifica o tipo de local, como cidade, endereço ou região.
-
- Análise de resultados
-
Informações sobre o grau de correspondência de cada resultado com a consulta de entrada.
-
MatchScores: pontuações que indicam a precisão de cada correspondência com a consulta de entrada.
-
- Outros detalhes
-
Fornece dados adicionais relacionados à localização.
-
TimeZone: informações de fuso horário do local. -
AccessPoints: coordenadas geográficas que representam pontos de entrada para o local.
-
