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
Geocodificação reversa converte coordenadas geográficas em um local ou endereço legível por humanos. Ela 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 no nível mais alto de preço de armazenamento. Use o parâmetro IntendedUse para especificar se os resultados são para uso único ou armazenamento. Consulte Preços de locais para obter detalhes sobre os custos associados aos resultados armazenados.
Para obter mais informações, consulte ReverseGeocode na Referência de API do Amazon Location Service.
Por obter exemplos de solicitações, respostas, comandos cURL e de CLI para essa API, consulte Como usar a geocodificação reversa.
Casos de uso
-
Adicione dados complementares aos dados de posição dos clientes: melhore os registros de dados de posição 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 posição, utilizando armazenamento persistente para referência contínua.
-
Determine 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 da API de geocodificação reversa aceita uma combinação de parâmetros obrigatórios e opcionais para personalizar os resultados. O parâmetro obrigatório QueryPosition (longitude e latitude) especifica as coordenadas para geocodificação reversa. Os parâmetros opcionais incluem AdditionalFeatures para dados extras, Filter para refinar resultados e MaxResults para limitar o número de resultados retornados. Opções adicionais como Language, PoliticalView e IntendedUse permitem uma maior personalização. Para obter mais detalhes, consulte a Referência de API de geocodificação reversa.
A solicitação aceita os seguintes parâmetros principais:
- Autenticação
-
O parâmetro
Keyé opcional quando outros métodos de autenticação são usados.-
Key: parâmetro opcional para autenticação.
Para obter mais informações, consulte Autenticação 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 pesquisa ao redor das coordenadas.
Para obter mais informações, consulte Consulta e desvios.
-
- Refinar resultados
-
Aplique filtros para limitar os resultados da pesquisa a países ou tipos de locais 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.
-
- Atributos adicionais
-
Solicita dados extras, como informações de 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 da API de geocodificação reversa fornece informações detalhadas sobre localizações nas coordenadas especificadas. A matriz ResultItems inclui uma lista de objetos de local, cada um contendo detalhes de endereço, categorias e posição geográfica. Dados adicionais como TimeZone, 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 de 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 retornado.
-
Address: informações de endereço completo, incluindo detalhes do país, região, código postal e 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 básicos.
-
- Tipos e categorias de locais
-
Descreve o tipo e a categoria do local retornado.
-
Categories: 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
-
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 sobre fuso horário da localização. -
AccessPoints: coordenadas geográficas que representam pontos de entrada para a localização.
-
