Pesquisa de lugares

Uma função essencial do Amazon Location Service é a capacidade de pesquisar as informações de geolocalização. O Amazon Location fornece essa funcionalidade por meio do recurso Índice de local.

nota

Para informações sobre como usar recursos de Índice de local para pesquisar na prática, consulte Pesquisando dados de localização e geolocalização usando Amazon Location.

Você pode usar as APIs de índice de local para pesquisar:

• Pontos de interesse, como restaurantes e pontos turísticos. Por nome e localização opcional da pesquisa e receber uma lista de opções ordenadas por relevância.

• Um endereço, recebendo uma latitude e longitude para esse endereço. Isso é conhecido como geocodificação.

• Uma posição de latitude e longitude, recebendo o endereço associado ou outras informações sobre o local. Isso é conhecido como geocodificação reversa.

• Uma consulta de texto de formato livre parcial ou com ortografia incorreta, normalmente quando o usuário digita. Isso é conhecido como preenchimento automático, sugestão automática ou correspondência difusa

O índice de local inclui qual provedor de dados usar para a pesquisa.

nota

Os dados do mapa e outras informações de geolocalização, inclusive localizações exatas, podem variar entre os provedores de dados. Como boa prática, use o mesmo provedor de dados para o seu índice de local, mapa e outros recursos do Amazon Location. Por exemplo, se os locais informados pelo seu índice de local não corresponderem à localização dos mesmos locais fornecidos pelo seu recurso de mapa, você poderá colocar um marcador no que parece ser a localização errada no mapa.

Veja a seguir como criar e usar recursos de índice de local:

1. Primeiro, você cria um recurso de índice de localização em sua AWS conta selecionando um provedor de dados.

2. Você pode então selecionar e instalar o SDK que corresponda ao seu ambiente de desenvolvimento e aplicativos. Para obter mais informações sobre as opções disponíveis, consulte o tópico sobre como Acessar o Amazon Location.

3. Comece a usar as APIs do Amazon Location Places. Para obter mais informações, consulte o tópico sobre o uso de Pesquisa de locais.

4. Em seguida, você pode integrar o monitoramento usando serviços como Amazon CloudWatch AWS CloudTrail e. Para obter mais informações, consulte Monitorando o Amazon Location Service com a Amazon CloudWatch e Registro e monitoramento com o AWS CloudTrail.

Conceitos de geocodificação

Um índice de local do Amazon Location fornece uma ação chamada SearchPlaceIndexForText, que permite especificar o texto a ser pesquisado. Por exemplo, você pode pesquisar por:

• Locais: uma busca por Paris pode retornar a localização da cidade na França.

• Empresas: uma busca por coffee shop pode retornar uma lista de cafeterias, incluindo seus nomes e localizações. Você também pode especificar uma localização para pesquisar ou uma caixa delimitadora para pesquisar e tornar os resultados mais relevantes. Nesse caso, fornecer uma localização no centro de Seattle, Washington, mostraria cafeterias nessa área.

• Endereços: uma busca por 1600 Pennsylvania Ave, Washington D.C. pode mostrar a localização da Casa Branca nos Estados Unidos (que está nesse endereço).

Pesquisar textos dessa forma geralmente é chamado de geocodificação, que envolve encontrar uma localização geográfica para o endereço ou local.

O Amazon Location Service também fornece uma ação de geocodificação reversa, chamada de SearchPlaceIndexForPosition Ela pega uma localização geográfica e mostra o endereço, a empresa ou outras informações sobre o que está naquela localização.

Resultados da pesquisa

Quando você faz uma solicitação de pesquisa bem-sucedida no Amazon Location Service, um ou mais resultados são exibidos. Cada resultado inclui um rótulo, que é o nome ou a descrição do resultado. Por exemplo, uma pesquisa por coffee shop pode exibir um resultado com o rótulo Hometown Cafe, informando que uma cafeteria chamada “Hometown Cafe” foi encontrada. Normalmente, o resultado da pesquisa também inclui um endereço estruturado (com propriedades como número do endereço, unidade, rua e código postal). Dependendo do provedor de dados, também incluirá outros metadados, como o país e o fuso horário.

Para uma pesquisa sobre o nome ou categoria de uma empresa (como coffee shop), talvez você queira mostrar todos os resultados exibidos em um mapa. Para uma pesquisa de endereço, talvez você queira usar o primeiro resultado automaticamente. Consulte o próximo tópico para obter informações sobre relevância.

Múltiplos resultados e relevância

Ao pesquisar por texto, o Amazon Location Service geralmente encontrará mais de um resultado único. Por exemplo, uma busca por Paris pode retornar a cidade na França, mas também a cidade no Texas. Os resultados são classificados por relevância, conforme determinado pelo provedor de dados.

nota

Os resultados são exibidos em ordem de relevância de todos os fornecedores. Se você escolher a Esri ou a Grab como o seu provedor de dados, os resultados incluem um valor de relevância que você pode usar para entender a relevância relativa entre os resultados de uma única solicitação.

Especificar informações adicionais, como o nome do país ou um local para pesquisar, pode alterar a ordem dos resultados, reduzir o número de resultados ou até mesmo alterar o conjunto de resultados retornados. Por exemplo, uma pesquisa por Paris em um local no Texas tem mais probabilidade de retornar Paris, Texas como o primeiro resultado do que Paris, France.

Em um aplicativo interativo, você pode usar a relevância para ajudar na decisão de aceitar o primeiro resultado ou pedir ao usuário que elimine a ambiguidade entre vários resultados retornados. Se o primeiro resultado tiver alta relevância, você pode simplesmente aceitá-lo como a resposta correta. Se houver múltiplos resultados de alta relevância ou nenhum resultado de alta relevância, você pode listar os resultados e deixar que o usuário selecione o melhor deles.

Resultados de endereço

Você pode pesquisar endereços com o Amazon Location Service usando a mesma ação SearchPlaceIndexForText. Quanto mais informações você fornecer, maior será a probabilidade de o endereço retornado corresponder ao fornecido. Por exemplo, 123 Main St é menos provável de encontrar um resultado correto do que 123 Main St, Anytown, California, 90210.

Os endereços têm vários atributos, como rua, número do local, cidade, região e código postal, etc. Esses atributos são usados para encontrar um endereço no índice de local que corresponda ao maior número possível de aspectos. Quanto mais atributos forem encontrados, mais relevante será a correspondência considerada e maior a probabilidade de ela ser retornada.

nota

A relevância dos resultados do endereço se baseia em até que ponto o resultado corresponde à entrada. Pode ser o número de atributos correspondentes, mas também pode ser até que ponto os resultados correspondem à entrada. Por exemplo, uma entrada de 123 Main St teria uma relevância maior quando Main St é encontrado nos dados do que se Maine St fosse o único resultado. Maine St ainda será exibido, mas provavelmente com um valor de relevância menor.

Os resultados da pesquisa incluem um rótulo para o endereço completo (123 Main St, Anytown, California, 90210), mas também os atributos individuais e estruturados do endereço exibido. Isso é útil porque você pode usar, por exemplo, para preencher campos de endereço em um banco de dados ou para examinar os resultados e encontrar a cidade, região ou código postal da localização encontrada.

Interpolação

Os endereços nos dados do índice de local incluem correspondências exatas de endereços. Por exemplo, suponha que haja uma rua 9th street e um quarteirão tenha 2 casas, 220 e240, como na imagem a seguir.

O provedor de dados cria os dados de geolocalização com esses dois endereços conhecidos. Você pode pesquisar esses dois endereços e eles serão encontrados. Depois que o provedor de dados criar os dados do mapa, vamos supor que uma nova casa seja adicionada entre os dois primeiros endereços. Esta nova casa recebe o endereço 230. Se você pesquisar 230 S 9th St, o provedor de dados ainda encontrará um resultado. Em vez de usar um endereço conhecido, ele interpolará entre os endereços já conhecidos e calculará a posição do novo endereço a partir deles. Nesse caso, ele pode deduzir que 230 está na metade do caminho entre 220 e 240 (e no mesmo lado da rua) e retornar uma localização aproximada com base nisso.

nota

Os provedores de dados atualizam periodicamente seus dados de geolocalização com novos endereços. Nesse caso, 230 S 9th St seria adicionado aos dados do provedor, mas normalmente haverá um período em que um novo endereço foi criado, mas ainda não foi adicionado aos dados.

Nesse caso, o provedor de dados não sabe se o novo endereço existe no mundo, pois ele ainda não está nos dados, mas fornece a melhor resposta possível com base nas informações que possui. Esse resultado é chamado de interpolado e pode ser retornado pelo provedor de dados nos resultados. Se interpolated retornar false, é um endereço conhecido. Se retornar true, é um endereço aproximado. Se não for retornado, o provedor de dados não informou se o resultado veio de interpolação.

Importante

O provedor de dados também pode retornar resultados interpolados para endereços que não existem. Por exemplo, neste caso, se você buscasse 232 S 9th St, o provedor encontraria esse endereço inexistente e retornaria um local próximo a 230, mas no lado 240. Endereços interpolados são úteis para levar você à localização certa, mas é bom ter em mente que eles não são endereços conhecidos.

Armazenamento de resultados de geocodificação

Ao criar um recurso de índice de local, você deve especificar uma opção de armazenamento de dados (chamada de IntendedUse na API). Isso pode ser definido como resultados de uso único ou armazenados. Ele está perguntando sobre o uso pretendido dos resultados. Se quiser armazenar os resultados (mesmo para fins de armazenamento em cache), você deve escolher a opção armazenamento e não a opção uso único.

nota

Quando você escolhe a opção de armazenamento (rotulada como Sim, os resultados serão armazenados no console ou escolhendo storage na CreatePlaceIndex API), o Amazon Location Service não armazena os resultados para você. É uma indicação de que você está planejando armazenar os resultados.

Ao analisar como você usará os resultados de suas consultas no Amazon Location Service, você deve sempre estar ciente dos Termos do serviço AWS aplicáveis.

Terminologia de locais

Recurso de índice de local

Permite que você escolha uma fonte de dados para dar suporte às consultas de pesquisas. Por exemplo, você pode pesquisar pontos de interesse, endereços ou coordenadas. Quando uma consulta de pesquisa é enviada para um recurso de índice de local, ela é atendida usando a fonte de dados configurada do recurso.

Geocodificação

A geocodificação é o processo de pegar uma entrada de texto, buscá-la no índice de local e retornar resultados com a posição.

Geocodificação reversa

A geocodificação reversa é o processo de receber uma posição e retornar informações sobre essa posição de dentro do índice de local, como endereço, cidade ou empresa naquela localização.

Relevância

Relevância é até que ponto um resultado corresponde à entrada. Não é uma medida de exatidão.

Interpolação

A interpolação é o processo de encontrar endereços desconhecidos usando localizações de endereços conhecidos como pontos de orientação.

Códigos de países ISO 3166.

O Amazon Location Service Places usa os códigos de país 3166 da Organização Internacional de Padronização (ISO - International Organization for Standardization,) para se referir a países ou regiões.

Para encontrar o código de um país ou região específicos, use a Plataforma de navegação on-line ISO