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

In questo documento scoprirai come utilizzare l'API Nearby Search (nuova) per creare una soluzione semplice e conveniente

Esperienza di scoperta locale.

Un'esperienza di scoperta locale mostra agli utenti i principali punti d'interesse nelle vicinanze di 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à.

sample local discovery

Casi d'uso

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

  • Scoperta: offri agli utenti una panoramica di ciò che si trova nei dintorni di una singola località mostrando luoghi pertinenti di vari tipi.

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

    rispetto a quel luogo.

  • Visualizzazione: fornisci recensioni e foto dei luoghi

    e la distanza percorsa a piedi, in modo che gli utenti possano capire rapidamente se si adatta alle loro esigenze.

Architettura di riferimento

alt_text

Ricerca locale

Esistono molti modi per creare un'esperienza di scoperta locale. La seguente integrazione è un esempio personalizzato di un'esperienza utente che sfrutta le API di Google Maps Platform ben note, oltre ad alcune nuove funzionalità interessanti. Se vuoi adottare un approccio basato su modelli per la scoperta locale, puoi utilizzare Componenti web.

Prova l'applicazione

Procedura dettagliata di esempio

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 AutocompleteSearch location

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

sample autocomplete

2. Mostrare i punti di interesse locali utilizzando l'API Nearby Search (nuova)

  • Ranking per popolarità (risultati più pertinenti) o ranking per distanza.
  • includedTypes, excludedTypes ; se sei un hotel, puoi escludere il tipo "lodging" e includere solo i tipi adatti, ad esempio "restaurant, cafe, park, tourit_attraction".
  • Utilizza includedPrimaryTypes e excludedPrimaryTypes per un controllo ancora maggiore sui risultati.
  • "locationRestriction" per evitare un numero insufficiente di risultati o luoghi troppo lontani; in caso di ZERO risultati, amplia le dimensioni del cerchio / del rettangolo prima di visualizzare i risultati.

Esempi di luoghi nelle vicinanze

Esempio di query quando prenoti un hotel con i 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 quando cerchi 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 e Directions

  • Tratte e passaggi aggiornati tramite query all'API Directions. * Utilizza il tempo nella sezione successiva.

indicazioni stradali di esempio

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

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

    Ora: proveniente dalla query dell'API Directions precedente.

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

  3. Immagini: durante l'anteprima senza restrizioni dell'API Ricerca nelle vicinanze (nuova), dovrai eseguire query su Dettagli luoghi con place.id per ottenere photo_reference per poi eseguire query una alla volta nella tua esperienza

dettagli dei luoghi

Conteggio delle query e costo associato

Conclusione

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

Passaggi successivi

Letture consigliate:

Collaboratori

Autori principali:

Thomas Anglaret | Google Maps Platform Solutions Engineer