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](places-pricing.md) para entender as implicações de custo dos resultados armazenados. Para obter mais informações, consulte [Geocodificação](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_Geocode.html) 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](https://docs.aws.amazon.com/location/latest/developerguide/how-to-geocode.html). ## 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](access.md) **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](places-querying-biasing.md) **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](places-filtering.md). **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](places-localization-internationalization.md) **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](additional-features.md). ## 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.