In questo documento, scoprirai come utilizzare l'API Nearby Search (nuova) su creare una soluzione semplice ed economica
un'esperienza di scoperta locale.
Un'esperienza di scoperta locale mostra agli utenti luoghi di interesse chiave nelle vicinanze di una località che specifichi quando cerchi un hotel o un immobile. Spesso consiste in un mappa interattiva, con un riquadro aggiuntivo contenente un selettore di luoghi e un galleria di foto. Ti verranno presentati diversi modelli di Google Maps Platform prodotti e funzionalità per migliorare l'esperienza di interazione.
Casi d'uso
Ora vediamo quali elementi dell'integrazione di Local Discovery indirizzano gli utenti valore:
Scoperta: offri agli utenti una panoramica di ciò che accade intorno a una singola località mostrando luoghi pertinenti di vario tipo.
Interattività - Consenti agli utenti di selezionare un luogo e aggiornare dinamicamente i dati
rispetto a quel luogo.
Visualizzazione: fornisci recensioni e foto di luoghi
e il tempo di percorrenza a piedi e la distanza affinché gli utenti capiscano rapidamente se è adatto le loro esigenze.
Architettura di riferimento
Scoperta locale
Esistono molti modi per creare un'esperienza di scoperta locale. Le seguenti di integrazione è un esempio personalizzato di esperienza utente che sfrutta bene note API di Google Maps Platform, nonché alcune nuove entusiasmanti funzionalità. Se Se vuoi avere un approccio basato su modelli alla scoperta locale, puoi usare Componenti.
Prova l'applicazione
Procedura dettagliata di esempio
Nella tabella sotto troverai l'applicazione di esempio suddivisa in passaggi insieme a una descrizione dell'implementazione tecnica con Google Maps le API della piattaforma.
1. Ricerca della posizione con AutocompleteSearch posizione
- Carica l'API Maps JavaScript.
- Luoghi di completamento automatico o scegli la posizione sulla mappa.
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 sei un hotel puoi escludere "lodging" e include solo i tipi adatti, ad es. "ristorante, bar, parco, tourit_attraction".- Utilizza
includedPrimaryTypes
eexcludedPrimaryTypes
per ottenere ancora di più controllo sui risultati. - "locationRestriction" per evitare un numero insufficiente di risultati o troppo lontano luoghi ; in caso di risultati ZERO, amplia la dimensione del cerchio / rettangolo prima per visualizzare i risultati.
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
- Aggiornate le tappe e i passaggi eseguendo una query su indicazioni stradali dell'API. * Usa il tempo nella sezione successiva.
4. Mostra informazioni dettagliate sul luogo al momento dell'interazione
Descrizione:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Tempo: proveniente dalla query precedente all'API Directions.
Recensioni:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Immagini: durante l'anteprima senza limitazioni dell'API Nearby Search (nuova), dovrà eseguire query su Places Dettagli con
place.id
per ottenere photo_reference per eseguire query una alla volta sulla tua esperienza
Numero di query e costo associato
- JavaScript su Maps dell'API: 1 mappa al caricamento dell'esperienza.
- API Places Autocomplete: 1 query ogni carattere digitato (se utilizzi il parametro Completamento automatico widget), può essere personalizzato.
- Ricerca nelle vicinanze (novità) dell'API: 1 query ogni 20 luoghi visualizzati. Fatturazione diversa in base alla Località dati che fanno parte della risposta alla query.
- Indicazioni stradali dell'API: 1 query per ogni luogo selezionato dall'utente.
- Foto del luogo dell'API: 1 query per ogni foto visualizzata.
Conclusione
Un'esperienza di scoperta locale è un modo efficace per offrire valore all'utente. Questo dell'implementazione della dimostrazione ha molte funzionalità che probabilmente includerai creando un'esperienza del genere su Google Maps Platform con funzionalità speciali dall'API Nearby Search (novità)
Passaggi successivi
Ulteriori letture suggerite:
- 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 | Google Maps Platform Solutions Engineer