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

In questo documento, esamineremo come utilizzare l'API Nearby Search (New) per creare un'esperienza di

scoperta locale semplice ed economica.

Un'esperienza di scoperta locale mostra agli utenti i principali luoghi di interesse vicino a una località specificata durante la ricerca di un hotel o di un immobile. Spesso è costituita da una mappa interattiva, con un riquadro aggiuntivo contenente un selettore del luogo 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 cerchiamo di capire quali elementi dell'integrazione della scoperta locale generano valore per l'utente:

  • Scoperta : offre agli utenti una panoramica di ciò che si trova intorno a una singola località mostrando luoghi pertinenti di vario tipo.

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

    relativi a quel luogo.

  • Visualizzazione - Fornisce recensioni, foto

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

Architettura di riferimento

alt_text

Scoperta locale

Esistono molti modi per creare un'esperienza di scoperta locale. La seguente integrazione è un esempio personalizzato di un'esperienza utente che sfrutta le note API di Google Maps Platform, nonché alcune nuove funzionalità interessanti. Se preferisci 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 di località con completamento automaticoCerca località

  • Carica l'API Maps JavaScript.
  • Esegui una query Place Autocomplete o scegli una località sulla mappa.

completamento automatico di esempio

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

  • Classifica in base alla popolarità (risultati più pertinenti) o alla distanza.
  • includedTypes, excludedTypes : se hai un hotel, puoi escludere il tipo "alloggio" e includere solo i tipi adatti, ad esempio: "ristorante, bar, parco, attrazione turistica".
  • Sfrutta includedPrimaryTypes, excludedPrimaryTypes per un controllo ancora maggiore sui risultati.
  • `locationRestriction` per evitare un numero insufficiente di risultati o luoghi troppo distanti; in caso di ZERO risultati, espandi le dimensioni del cerchio / rettangolo prima di visualizzare i risultati.

Esempio di luoghi nelle vicinanze

Esempio di query durante la prenotazione di un hotel con i campi 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 } } }

Esempio di query durante la ricerca di un immobile con i campi 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. Aggiungi interattività con le API Mappe dinamiche e API Directions

  • Tratte e passaggi aggiornati eseguendo una query sull'API Directions. * Utilizza il tempo nella sezione successiva.

indicazioni stradali di esempio

4. Mostra informazioni dettagliate sul luogo dopo l'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 restrizioni dell'API Nearby Search (New), dovrai eseguire una query su Place Details con place.id per ottenere photo_reference e poi eseguire una query alla volta nella tua esperienza

places details

Numero di 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 dall'API Nearby Search (New) .

Passaggi successivi

Letture consigliate:

Collaboratori

Autori principali:

Thomas Anglaret | Solutions Engineer di Google Maps Platform