Geocodificar - Amazon Location Service
Casos de usoEntenda a solicitaçãoEntenda 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á.

Geocodificar

A geocodificação transforma endereços textuais ou nomes de lugares em coordenadas geográficas, junto com componentes de endereço detalhados e informações adicionais. Essa API oferece suporte a 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 IntendedUse parâmetro para indicar uso único ou armazenamento. Consulte o Preços de lugares para entender as implicações de custo dos resultados armazenados.

Para obter mais informações, consulte Geocode na 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.

Casos de uso

  • Adicione dados complementares aos endereços dos clientes: melhore os registros de endereços incluindo códigos postais, coordenadas e utilizando armazenamento persistente para apoiar decisões comerciais e de 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.

  • Determine os 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.

Entenda a solicitação

A solicitação aceita parâmetros opcionais, comoAdditionalFeatures, e BiasPositionFilter, para refinar os resultados da pesquisa. Opções adicionais, como LanguageMaxResults, ePoliticalView, fornecem mais personalização da resposta. O parâmetro necessário éQuery, que pode ser fornecido como texto de formato livre ou estruturado comoQueryComponents. Para obter mais informações, consulte a Referência da API Geocode.

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

Autenticação

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

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

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

Consulta e distorção

Parâmetros usados para consulta e distorção geográfica dos 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 direcionar os resultados da pesquisa.

Para obter mais informações, consulte Consulta e distorção.

Refinando os 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 resultados localizados.

  • Language: Linguagem 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

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.

Entenda a resposta

A resposta forneceResultItems, que contém dados de localização detalhadosAddress, comoPlaceId,Position, e outros atributos relevantes. Recursos adicionais, como TimeZone informações ou MatchScores para cada componente de consulta, também podem ser incluídos. Cada um 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 Geocode.

A resposta inclui os seguintes parâmetros principais:

Endereço e detalhes relacionados

Detalhes sobre o local devolvido, 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 base.

Tipos e categorias de lugares

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

  • Categories: Lista de categorias que descrevem o local, por exemplo, restaurantes, 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 combinar a precisão.

    • Overall: mede o quão bem 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 ouPostalCode) é pontuado individualmente 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, seAddressNumber,Street, e PostalCode pontuar perto de 1,0, você pode confiar na partida mesmo que a pontuação geral seja menor devido a outros detalhes da consulta.

    nota

    Quando nenhuma pontuação aparece para um componente específico (comoStreet), esse componente é contado como 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 no mundo real, que geralmente incluem informações extras.

Outros detalhes

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

  • AccessPoints: Coordenadas geográficas representando pontos de acesso.

  • TimeZone: informações de fuso horário do local.