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

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

esperienza di scoperta locale.

Un'esperienza di scoperta locale mostra agli utenti i luoghi di interesse principali nelle vicinanze di una località specificata durante la ricerca di un hotel o di una proprietà immobiliare. Spesso consiste in 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 interattività.

esempio di scoperta locale

Casi d'uso

Ora vediamo quali elementi dell'integrazione di rilevamento locale generano valore per gli utenti:

  • Scoperta - Offri agli utenti una panoramica degli elementi intorno a una singola località mostrando luoghi pertinenti di vari tipi.

  • Interattività: consenti agli utenti di selezionare un luogo e aggiornare i dati in modo dinamico

    rispetto a quel luogo.

  • Visualizzazione: fornisci recensioni e foto di luoghi

    e il tempo di percorrenza a piedi e la distanza percorsa, in modo che gli utenti capiscano rapidamente se è adatto alle loro esigenze.

Architettura di riferimento

alt_text

Scoperta locale

Esistono diversi modi per creare un'esperienza di scoperta a livello locale. La seguente integrazione è un esempio personalizzato di esperienza utente che sfrutta le note API di Google Maps Platform e alcune nuove funzionalità straordinarie. Se vuoi avere un approccio al rilevamento locale basato su modelli, puoi utilizzare i componenti web.

Prova l'applicazione

Esempio di procedura dettagliata

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

1. Ricerca posizione con AutocompleteSearch per la posizione

  • Carica l'API Maps JavaScript.
  • Completamento automatico di Places o scegli la posizione sulla mappa.

completamento automatico di esempio

2. Mostra i punti d'interesse locali utilizzando l'API Nelle vicinanze (nuova)

  • Ranking di popolarità (risultati più pertinenti) o ranking in base alla distanza.
  • includedTypes, excludedTypes; se sei un hotel, puoi escludere il tipo di alloggio e includere solo le tipologie adatte, ad esempio "ristorante, caffetteria, parco, attrazione_tourit".
  • Sfrutta includedPrimaryTypes, excludedPrimaryTypes per un controllo ancora maggiore sui risultati.
  • "locationRestrizione per evitare un numero di risultati insufficiente o luoghi troppo lontani "; in caso di risultati ZERO, amplia la dimensione del cerchio / del rettangolo prima di visualizzare i risultati.

esempio di luoghi nelle vicinanze

Esempio di query per la prenotazione di un hotel con campi di dati richiesti:

  • Di 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 per la ricerca di un immobile con i campi di dati richiesti:

  • Di 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 l'API Dynamic Maps e Directions

  • Aggiorna leg e passaggi eseguendo una query sull'API Directions. * Usa l'ora nella sezione successiva.

indicazioni di esempio

4. Visualizza informazioni dettagliate sul luogo al momento dell'interazione

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

    Ora: proveniente dalla precedente query 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 Places Details con place.id per ottenere photo_reference e poi eseguire query una alla volta nella tua esperienza

dettagli dei luoghi

Numero di query e costo associati

Conclusione

Un'esperienza di rilevamento locale è un modo efficace per offrire valore agli utenti. Questa implementazione dimostrativa ha molte funzionalità che potresti includere durante la creazione di un'esperienza di questo tipo su Google Maps Platform con funzionalità speciali dall'API Nearby Search (nuova) .

Passaggi successivi

Ulteriore lettura suggerita:

Collaboratori

Autori principali:

Thomas Anglaret | Platform Solutions Engineer di Google Maps