Melhore a descoberta local com a API Nearby Search (nova)

Neste documento, você vai aprender a usar a API Nearby Search (nova) para criar uma experiência de descoberta local simples e econômica

para os usuários.

Uma experiência de descoberta local mostra aos usuários os principais lugares de interesse perto de um local especificado ao pesquisar um hotel ou imóvel. Geralmente, ela consiste em um mapa interativo, com um painel extra que contém um seletor de lugar e uma galeria de fotos. Você vai conhecer diferentes produtos e recursos da Plataforma Google Maps para melhorar a experiência com interatividade.

exemplo de descoberta local

Casos de uso

Agora, vamos entender quais elementos da integração de descoberta local geram valor para o usuário:

  • Descoberta : ofereça aos usuários uma visão geral do que está ao redor de um único local mostrando lugares relevantes de vários tipos.

  • Interatividade : permita que os usuários selecionem um lugar e atualizem os dados dinamicamente

    relativos a ele.

  • Visualização : forneça avaliações de lugares, fotos

    e tempo e distância de caminhada para que os usuários entendam rapidamente se o local atende às necessidades deles.

Arquitetura de referência

alt_text

Descoberta local

Há muitas maneiras de criar uma experiência de descoberta local. A integração a seguir é um exemplo personalizado de uma experiência do usuário que aproveita APIs conhecidas da Plataforma Google Maps, bem como alguns novos recursos interessantes. Se você quiser uma abordagem com modelo para a descoberta local, use os componentes da Web.

Aplicativo de amostra

Exemplo de tutorial

Na tabela abaixo, você encontra o aplicativo de amostra dividido em etapas, juntamente com uma descrição da implementação técnica com as APIs da Plataforma Google Maps.

1. Pesquisa de local com o AutocompleteSearch location

  • Carregue a API Maps JavaScript.
  • Faça uma consulta do Place Autocomplete ou escolha um local no mapa.

exemplo de preenchimento automático

2. Mostre pontos de interesse locais usando a API Nearby Search (nova)

  • Classificação de popularidade (resultados mais relevantes) ou classificação de distância.
  • includedTypes, excludedTypes: se você for um hotel, poderá excluir o tipo "lodging" e incluir apenas os tipos adequados, ou seja, "restaurant, cafe, park, tourit_attraction".
  • Aproveite includedPrimaryTypes, excludedPrimaryTypes para ter ainda mais controle sobre os resultados.
  • `locationRestriction` para evitar um número insuficiente de resultados ou lugares muito distantes. Em caso de ZERO resultados, amplie o tamanho do círculo / retângulo antes de mostrar os resultados.

mostrar lugares por perto

Exemplo de consulta ao reservar um hotel com os campos de dados solicitados:

  • Básico (displayName, types, openingHours, formattedAddress)
  • Contato (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferencial (reviews, priceLevel, userRatingCount)
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

Exemplo de consulta ao pesquisar um imóvel com os campos de dados solicitados:

  • Básico (displayName, types, openingHours, formattedAddress)
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Adicione interatividade com a API Dynamic Maps e a API Directions

  • Trechos e etapas atualizados consultando a API Directions. * Use o tempo na próxima seção.

exemplo de rotas

4. Mostre informações detalhadas do lugar após a interação

  1. Descrição: displayName, types, rating, userRatingCount, priceLevel.

    Tempo: vem da consulta anterior da API Directions.

  2. Avaliações: reviews[i].author, reviews[i].rating,reviews[i].text.

  3. Imagens: durante a visualização irrestrita da API Nearby Search (nova), você terá que consultar os detalhes de lugares com place.id para receber photo_reference e, em seguida, consultar uma de cada vez na sua experiência.

detalhes do lugar

Contagem de consultas e custo associado

Conclusão

Uma experiência de descoberta local é uma maneira eficaz de gerar valor para o usuário. Essa implementação de demonstração tem muitos recursos que você provavelmente vai incluir ao criar uma experiência desse tipo na Plataforma Google Maps com recursos especiais da API Nearby Search (nova) .

Próximas etapas

Leituras sugeridas:

Colaboradores

Principais autores:

Thomas Anglaret | Engenheiro de soluções da Plataforma Google Maps