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à.
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
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.
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 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.
4. Visualizza informazioni dettagliate sul luogo al momento dell'interazione
Descrizione:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Ora: proveniente dalla precedente query dell'API Directions.
Recensioni:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.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
Numero di query e costo associati
- API Maps JavaScript: 1 mappa al caricamento dell'esperienza.
- API Places Autocomplete: una query per ogni carattere digitato (se utilizzi il widget di completamento automatico), può essere personalizzata.
- API Nearby Search (nuova): una query ogni 20 luoghi visualizzati. Fatturazione diversa in base ai dati del luogo che fanno parte della risposta alla query.
- API Directions: una query per ogni luogo selezionato dall'utente.
- API Place Photo: una query per ogni foto visualizzata.
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:
- Componenti web nell'API Maps JavaScript
- Ottimizzazione del completamento automatico di Places
- Altri servizi di Places
- Lascia un feedback di seguito.
Collaboratori
Autori principali:
Thomas Anglaret | Platform Solutions Engineer di Google Maps