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](places-pricing.md) para obter detalhes sobre os custos associados aos resultados armazenados. Para obter mais informações, consulte [ReverseGeocode](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html)a *Amazon Location Service API Reference*. Por obter exemplos de solicitações, respostas, comandos cURL e de CLI para essa API, consulte [Como usar a geocodificação reversa](https://docs.aws.amazon.com/location/latest/developerguide/reverse-geocode-how-to.html). ## 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 **nota** Para clientes em `ap-southeast-1` e`ap-southeast-5`, os campos de solicitação e resposta compatíveis podem ser diferentes. Consulte a [Referência da ReverseGeocode API](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_ReverseGeocode.html) para obter detalhes. 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 da 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](access.md). **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](places-querying-biasing.md). **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](places-filtering.md). **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](places-localization-internationalization.md). **Características 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](additional-features.md). ## 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 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 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.