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

In questo documento, scoprirai come utilizzare l'API Nearby Search (nuova) per creare un'API semplice e conveniente.

un'esperienza di scoperta locale.

Un'esperienza di scoperta locale mostra agli utenti i principali luoghi di interesse nelle vicinanze di una località specificata quando cercano un hotel o una proprietà immobiliare. Spesso è costituito 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 di interattività.

esempio di rilevamento locale

Casi d'uso

Ora vediamo quali elementi dell'integrazione di Local Discovery generano valore per l'utente:

  • Rilevamento - Fornisci agli utenti una panoramica di ciò che si trova intorno a una singola località mostrando luoghi pertinenti di vari tipi.

  • Interattività - Consenti agli utenti di selezionare un luogo e aggiornare dinamicamente i dati

    rispetto a quel luogo.

  • Visualizzazione: fornisci recensioni e foto di luoghi

    nonché la distanza e il tempo di percorrenza a piedi affinché gli utenti capiscano 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 esperienza utente che sfrutta le note API Google Maps Platform e alcune nuove funzionalità molto interessanti. Se vuoi un approccio basato su modelli per il rilevamento locale, puoi utilizzare Componenti web.

Prova l'applicazione

Procedura dettagliata di esempio

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

1. Ricerca della posizione con AutocompleteSearch posizione

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

completamento automatico di esempio

2. Mostra i punti d'interesse locali utilizzando l'API Nearby Search (nuova)

  • Ranking di popolarità (risultati più pertinenti) o ranking della distanza.
  • includedTypes, excludedTypes; se hai un hotel, puoi escludere il tipo di "alloggio" e includere solo i tipi più adatti, ad esempio "ristorante, bar, parco, tourit_attraction".
  • Utilizza includedPrimaryTypes e excludedPrimaryTypes per avere un controllo ancora maggiore sui risultati.
  • "locationRestriction" per evitare un numero insufficiente di risultati o luoghi troppo lontani; in caso di risultati pari a ZERO, amplia la dimensione di cerchio / rettangolo prima di visualizzare i risultati.

esempi di luoghi nelle vicinanze

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

  • Di base (displayName, types, openingHours, formattedAddress)
  • Contatto (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferita (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 in una proprietà immobiliare 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 and Directions

  • Aggiorna la tappa e i passaggi eseguendo una query sull'API Directions. * Usa il tempo nella sezione successiva.

indicazioni di esempio

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

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

    Tempo: proveniente dalla query precedente all'API Directions.

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

  3. Immagini: durante l'anteprima senza restrizioni dell'API Nearby Search (nuova), dovrai eseguire query su Places Details con place.id per ottenere photo_reference quindi eseguire query una alla volta nella tua esperienza

dettagli sui luoghi

Numero di query e costo associato

Conclusione

Un'esperienza di scoperta locale è un modo efficace per offrire valore all'utente. Questa implementazione dimostrativa ha molte funzionalità che potresti includere quando creerai un'esperienza di questo tipo su Google Maps Platform con funzionalità speciali dell'API Nearby Search (nuova) .

Passaggi successivi

Ulteriori letture suggerite:

Collaboratori

Autori principali:

Thomas Anglaret | Google Maps Platform Solutions Engineer