Migliora la scoperta locale con l'API nelle vicinanze (nuova)

In questo documento, esaminerai come utilizzare l'API Nearby Search (New) per creare un'applicazione semplice ed economica

esperienza di scoperta locale.

Un'esperienza di scoperta locale mostra agli utenti i principali luoghi di interesse vicino a una località che specifichi quando cerchi un hotel o un immobile. Spesso è costituita da una mappa interattiva, con un riquadro aggiuntivo contenente un selettore di luoghi e una galleria di foto. Ti verranno presentati diversi prodotti e funzionalità di Google Maps Platform per migliorare l'esperienza con l'interattività.

esempio di scoperta locale

Casi d'uso

Ora vediamo quali elementi dell'integrazione della ricerca locale generano valore per gli utenti:

  • Esplorazione: offre agli utenti una panoramica di ciò che si trova nei dintorni di una singola località mostrando luoghi pertinenti di vario tipo.

  • Interattività: consente agli utenti di selezionare un luogo e aggiornare dinamicamente i dati

    rispetto a quel luogo.

  • Visualizzazione - Fornisci recensioni, foto di luoghi

    e il tempo e la distanza a piedi per consentire agli utenti di capire rapidamente se soddisfa le loro esigenze.

Architettura di riferimento

alt_text

Local Discovery

Esistono molti modi per creare un'esperienza di scoperta locale. La seguente integrazione è un esempio personalizzato di un'esperienza utente che sfrutta API di Google Maps Platform ben note, nonché alcune nuove funzionalità entusiasmanti. Se vuoi un approccio basato su modelli per la scoperta locale, puoi utilizzare i componenti web.

Prova l'applicazione

Esempio di procedura dettagliata

Nella tabella seguente troverai l'applicazione di esempio suddivisa in passaggi insieme a una descrizione dell'implementazione tecnica con le API di Google Maps Platform.

1. Ricerca località con completamento automatico

  • Carica l'API Maps JavaScript.
  • Query Places Autocomplete o scegli la posizione sulla mappa.

completamento automatico di esempio

2. Mostra i punti di interesse locali utilizzando l'API Nearby Search (novità)

  • Classifica per popolarità (risultati più pertinenti) o per distanza.
  • includedTypes, excludedTypes; se sei un hotel, puoi escludere il tipo "alloggio" e includere solo i tipi adatti, ad esempio: "ristorante, bar, parco, attrazione turistica".
  • Sfrutta includedPrimaryTypes e excludedPrimaryTypes per avere ancora più controllo sui risultati.
  • `locationRestriction to avoid insufficient number of results or too far away places ; in case of ZERO results, broaden the circle / rectangle size prior to display results.

Esempio di luoghi nelle vicinanze

Query di esempio durante la prenotazione di un hotel con i campi di dati richiesti:

  • Base (displayName, types, openingHours, formattedAddress)
  • Contatto (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferito (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 } } }

Query di esempio durante la ricerca di un immobile con i campi di dati richiesti:

  • Base (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. Aggiungere interattività con l'API Dynamic Maps e Directions

  • Gambe e passi aggiornati eseguendo query sull'API Directions. * Utilizza l'ora nella sezione successiva.

indicazioni stradali di esempio

4. Mostrare informazioni dettagliate sul luogo in seguito all'interazione

  1. Descrizione: displayName, types, rating, userRatingCount, priceLevel.

    Ora: proviene dalla query precedente dell'API Directions.

  2. Recensioni: reviews[i].author, reviews[i].rating,reviews[i].text.

  3. Immagini: durante l'anteprima senza limitazioni della nuova API Nearby Search, dovrai eseguire query su Places Details con place.id per ottenere photo_reference e poi eseguire query una alla volta nella tua esperienza.

places details

Conteggio delle query e costi associati

Conclusione

Un'esperienza di scoperta locale è un modo efficace per offrire valore agli utenti. Questa implementazione dimostrativa include molte funzionalità che probabilmente includerai quando crei un'esperienza di questo tipo su Google Maps Platform con funzionalità speciali dell'API Nearby Search (New) .

Passaggi successivi

Letture consigliate:

Collaboratori

Autori principali:

Thomas Anglaret | Google Maps Platform Solutions Engineer