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

Neste documento, você verá como usar a API Nearby Search (nova) para criar uma API simples e econômica

de descoberta local.

Uma experiência de descoberta local mostra aos usuários os principais lugares de interesse perto de um local que você especificou ao pesquisar um hotel ou uma imobiliária. Ele geralmente consiste em um mapa interativo, com um painel adicional que contém um seletor de lugar e uma galeria de fotos. Você verá diferentes produtos e recursos da Plataforma Google Maps para melhorar a experiência com interatividade.

Casos de uso

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

• Descoberta: ofereça aos usuários uma visão geral do que há 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.

  em relação àquele lugar.

• Visualização - Forneça avaliações e fotos de lugares

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

Arquitetura de referência

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 utiliza as APIs conhecidas da Plataforma Google Maps, além de alguns novos recursos interessantes. Se você quiser ter um modelo de abordagem para descoberta local, use os Componentes da Web.

Aplicativo de amostra

Exemplo de tutorial

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

1. Pesquisa de local com o local AutocompleteSearch

• Carregue a API Maps JavaScript.
• consulta do Places Autocomplete ou escolha o local no mapa.

2. Mostrar 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" (hospedagem) e incluir apenas os tipos adequados, ou seja, "restaurante, café, parque, tourit_attraction".
• Use includedPrimaryTypes e excludedPrimaryTypes para ter ainda mais controle sobre os resultados.
• `locationRestriction para evitar número insuficiente de resultados ou locais muito distantes; no caso de ZERO resultados, aumente o tamanho do círculo / retângulo antes de exibir os resultados.

Exemplo de consulta ao reservar um hotel com 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 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 o Dynamic Maps e a API Directions

• Percurso e etapas atualizados. Para isso, consulte a API Directions. * Use o tempo na próxima seção.

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

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

   Horário: proveniente da consulta anterior da API Directions.

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

3. Imagens: durante a Visualização irrestrita da API Nearby Search (nova), você vai precisar consultar os Places Details com place.id para acessar photo_reference e consultar um por vez na sua experiência.

Contagem de consultas e custo associado

• API Maps JavaScript: um mapa no carregamento da experiência.
• API Places Autocomplete: uma consulta para cada caractere digitado (se estiver usando o widget Autocomplete) que pode ser personalizada.
• API Nearby Search (novo): uma consulta a cada 20 lugares exibidos. Faturamento diferente de acordo com os dados do Place que fazem parte da resposta da consulta.
• API Directions: uma consulta para cada local selecionado pelo usuário.
• API Place Photo: uma consulta para cada foto exibida.

Conclusão

Uma experiência de descoberta local é uma ótima maneira de agregar valor ao usuário. Essa implementação de demonstração tem muitos recursos que você provavelmente vai incluir ao criar essa experiência na Plataforma Google Maps com recursos especiais da API Nearby Search (novo) .

Próximas etapas

Leitura adicional sugerida:

• Web Components na API Maps JavaScript
• Otimização do Place Autocomplete
• Outros serviços do Places
• Deixe seu feedback abaixo.

Colaboradores

Autores principais:

Thomas Anglaret, engenheiro de soluções da Plataforma Google Maps