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à.

esempio di rilevamento locale

Casi d'uso

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

  • 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 di luoghi

    e la distanza percorsa a piedi, in modo che gli utenti possano capire rapidamente se è 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 desideri un approccio al rilevamento locale basato su modelli, 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. Mostra i punti d'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 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 quando prenoti 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 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. * Usa il tempo nella sezione successiva.

indicazioni stradali di esempio

4. Mostra 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 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