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 i principali luoghi di 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 modelli di Google Maps Platform prodotti e funzionalità per migliorare l'esperienza di interazione.
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 accade intorno a una singola località mostrando luoghi pertinenti di vario tipo.
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
Ricerca 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".- Sfrutta
includedPrimaryTypes
eexcludedPrimaryTypes
per ottenere ancora di più controllo 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.
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
) - 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. * Usa il tempo nella sezione successiva.
4. Mostrare informazioni dettagliate sul luogo al momento dell'interazione
Descrizione:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Ora: proveniente dalla query dell'API Directions precedente.
Recensioni:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.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
Numero di query e costo associato
- JavaScript su Maps dell'API: 1 mappa al caricamento dell'esperienza.
- API Places Autocomplete: 1 query per ogni carattere digitato (se utilizzi il widget Autocomplete), puoi personalizzarla.
- 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.
- API Directions: 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 dimostrativa presenta molte funzionalità che potresti includere 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