Esiste una versione più recente di questo documento con esempi di utilizzo delle nuove API Places e Routes.
In genere, quando l'utente guida verso un punto d'interesse, ha bisogno di indicazioni stradali per una località vicina, ad esempio un parcheggio o un punto di accesso. Immagina un autista che deve andare in un aeroporto o in un centro commerciale. Quando si reca in un aeroporto, l'autista sta cercando di raggiungere un terminal o un punto di discesa piuttosto che il centro del complesso aeroportuale. Allo stesso modo, un parcheggio accanto al centro commerciale potrebbe essere un'opzione molto migliore per un utente con un'auto. In questo caso, quando sviluppi un'app o un servizio per guidare l'autista, trova prima la posizione in cui si sta recando e poi offri all'autista destinazioni facoltative vicino a quella posizione. Questo approccio ti consente di fornire un servizio migliore ai tuoi clienti e dimostrare che apprezzi il loro tempo, con un piccolo ma intelligente sforzo di sviluppo che sfrutta i dati sulla posizione forniti da Google Maps Platform.
Visualizzazione semplificata dei sistemi coinvolti quando si guida il conducente verso una destinazione in auto
Ti mostreremo come utilizzare Places API e Directions API in sequenza o in combinazione per individuare il luogo giusto in cui parcheggiare vicino alla tua destinazione. Questa soluzione mira a eliminare l'incertezza e le molteplici interazioni necessarie per trovare un parcheggio mentre si guida più vicini alla destinazione finale. Vediamo due esempi di come questi casi potrebbero essere implementati in dettaglio.
Esempio 1: un'attrazione turistica senza parcheggio
Scegliamo una località non direttamente collegata alla strada, in modo che il percorso debba essere recuperato separatamente; la destinazione è Notre Dame a Parigi e come punto di partenza utilizziamo la stazione ferroviaria Gare de l'Est (48.87697775149635, 2.3592247806755564).
L'autista lascia la stazione a circa 16 minuti a nord di Notre Dame. Notre Dame è una famosa attrazione turistica su un'isola con accesso tramite ponte, alcune strade a senso unico e nessun grande parcheggio disponibile nelle vicinanze, quindi questa dovrebbe essere una sfida interessante.
Richiesta API Places
Questa richiesta dell'API Places utilizza la "ricerca di testo" per trovare Notre Dame. Per i dettagli, consulta la documentazione per sviluppatori. "YOUR_KEY" in questi esempi è la chiave API che hai per le API Places e Directions di Google Maps Platform abilitate nella console Google Cloud. Per una spiegazione più dettagliata, consulta la documentazione su come iniziare a utilizzare Google Maps Platform.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
La risposta alla richiesta precedente fornisce le seguenti coordinate di latitudine e longitudine:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Come puoi vedere, le coordinate indicano effettivamente Notre Dame.
|
|
Come sviluppatore o fornitore di servizi, è una buona idea chiedere automaticamente al conducente "Cerchi parcheggio vicino a Notre Dame?". L'esperienza utente varia a seconda del dispositivo e dello schermo, ma in questo caso potrebbe valere la pena considerare un testo popup discreto che scompare dopo poco tempo. Per trovare un parcheggio vicino a Notre Dame, effettua una ricerca di testo tramite l'API Places impostando i parametri "parcheggio" e "raggio 300". Questo esempio influenzerà i risultati in base alle aree di parcheggio entro 300 metri da Notre Dame.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
Il primo risultato è "Parking Saemes Maubert-Lagrange" alle coordinate 48.850591, 2.3486436. Utilizziamo questa posizione nella parte successiva, in cui eseguiamo una richiesta all'API Directions.
Richiesta dell'API Directions
Per trovare il percorso dalla stazione a un parcheggio vicino a Notre Dame, devi inviare una richiesta all'API Directions. Devi solo impostare i parametri di origine e destinazione. Per altre opzioni, consulta la documentazione per gli sviluppatori.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
La risposta dell'API Directions in genere contiene più suggerimenti per l'itinerario. Ogni percorso è composto da più "tratte" e queste contengono più "passaggi" che mostrano la distanza e le coordinate del viaggio. Per trovare le coordinate finali raggiungibili in auto, utilizza il campo "end_location" dell'ultimo passaggio dell'ultimo segmento di un percorso che hai selezionato.
Questa posizione potrebbe non sembrare la prima scelta, ma se guardi la mappa o Google Street View, scoprirai che si trova a pochi minuti a piedi, circa 6-7 minuti, da Notre Dame.
Percorso a piedi dal parcheggio a Notre-Dame
Riepilogo per l'esempio 1
Come puoi vedere, trovare un parcheggio per un'auto richiede solo poche chiamate API e la visualizzazione del suggerimento al conducente. In questo modo, gli utenti risparmiano tempo perché non devono guidare in strade a senso unico o cercare un posto dove parcheggiare l'auto in un'attrazione turistica affollata. In sintesi, abbiamo effettuato le seguenti richieste API:
- Una richiesta dell'API Places per trovare le coordinate di Notre Dame
- Una richiesta dell'API Places per trovare un parcheggio entro 300 metri da queste coordinate
- Una richiesta dell'API Directions per trovare un percorso per l'area di parcheggio
Esempio 2: indicazioni per raggiungere un terminal in un grande aeroporto
"types" : [ "airport", "point_of_interest", "establishment" ],
Tuttavia, chiunque abbia visitato un grande aeroporto sa che ci vuole molto tempo per spostarsi tra i terminal se si arriva nel posto sbagliato. In questo caso, poiché il tipo di risultato di ricerca è "aeroporto", è utile eseguire automaticamente una query di follow-up per cercare "terminal" utilizzando la posizione dell'aeroporto di Londra Heathrow (51.47016927594547, -0.45432767852489075). Nell'esempio puoi anche vedere la limitazione facoltativa del raggio di ricerca di 3000 metri.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
La query precedente fornisce un elenco dei terminal e dei singoli punti di riconsegna in questi terminal. Dall'elenco dei risultati possiamo trovare "London Heathrow Airport Terminal 5" e il relativo ID luogo:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Utilizzando il parametro "place_id", possiamo comunicare all'API Directions che stiamo cercando di raggiungere un luogo anziché coordinate arbitrarie.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Come nell'esempio precedente, leggendo tutti i passaggi nella risposta JSON troverai l'ultima parte del viaggio e le coordinate di latitudine e longitudine delle località di destinazione (51.47079979999999,-0.4896765).
Riepilogo per l'esempio 2
Come nell'esempio precedente, lo sforzo di sviluppo per fornire indicazioni migliorate al conducente è molto ridotto e i vantaggi in termini di tempo risparmiato dal conducente sono facilmente misurabili. Abbiamo effettuato le seguenti richieste:
- Una richiesta dell'API Places per trovare l'aeroporto di Heathrow
- Una richiesta dell'API Places per trovare tutti i terminal vicini alle coordinate dell'aeroporto di Heathrow
- Una richiesta dell'API Directions per ottenere un percorso per il terminal 5
Conclusione
Come puoi vedere, lo sforzo di sviluppo necessario per fornire un servizio premium ai tuoi clienti che viaggiano in auto è piuttosto ridotto e ti consente di dimostrare facilmente come tieni in considerazione le esigenze dei tuoi clienti.
Per scopi di sviluppo, puoi utilizzare molte delle librerie e degli strumenti disponibili per creare i servizi per i tuoi clienti. Dai un'occhiata al nostro repository GitHub per Google Maps Platform disponibile pubblicamente.
Azioni successive
- Navigazione dall'esterno all'interno
- Creare una funzionalità di convalida della posizione con Google Maps
Autore principale
Mikko Toivanen | Google Maps Platform Solutions Engineer