Esiste una versione più recente di questo documento con esempi di utilizzo delle nuove API Places e Routes.
In genere, quando l'utente si reca in auto a un punto d'interesse (PDI), deve effettivamente richiedere la navigazione verso una località nelle vicinanze, ad esempio un parcheggio o un punto di accesso. Immagina un conducente che deve andare a un aeroporto o a un centro commerciale. Quando si reca in un aeroporto, il conducente sta cercando di raggiungere un terminal o un punto di consegna anziché 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 il conducente, trova prima la destinazione che deve raggiungere e poi offri al conducente destinazioni facoltative nelle vicinanze. Questo approccio ti consente di offrire un servizio migliore ai tuoi clienti e di dimostrare che apprezzi il loro tempo, con un impegno di sviluppo ridotto, ma intelligente, che sfrutta i dati sulla posizione forniti da Google Maps Platform.
Ti mostreremo come utilizzare l'API Places e l'API Maps in sequenza o in combinazione per identificare il luogo giusto per parcheggiare vicino alla tua destinazione. Questa soluzione mira a rimuovere l'incertezza e le molteplici interazioni per trovare un parcheggio mentre guidi, una volta raggiunta la destinazione finale. Vediamo due esempi di come queste situazioni potrebbero essere implementate in dettaglio.
Esempio 1: un'attrazione turistica senza parcheggio
Scegliamo una località non direttamente collegata alla strada, in modo che sia necessario recuperare un percorso separatamente. La destinazione è Notre Dame a Parigi e come punto di partenza utilizziamo la stazione ferroviaria Gare de l'Est (48.87697775149635, 2.3592247806755564).
Il conducente 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 dovrebbe essere una sfida interessante.
Richiesta dell'API Places
Questo esempio di richiesta all'API Places utilizza la "ricerca di testo" per trovare Notre Dame. Per ulteriori 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 attivate nella console Google Cloud. Per una spiegazione più dettagliata, consulta la documentazione relativa all'utilizzo iniziale di 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.
|
|
In qualità di sviluppatore o fornitore di servizi, è buona norma chiedere automaticamente al conducente: "Cerchi un parcheggio vicino a Notre Dame?". L'esperienza utente sarà diversa a seconda del dispositivo e dello schermo, ma in questo caso potrebbe valere la pena prendere in considerazione un testo popup discreto che scompare dopo poco tempo. Per trovare un parcheggio vicino a Notre Dame, esegui una ricerca di testo dell'API Places con i parametri di tipo "parking" e raggio "300" impostati. Questo esempio influenzerà i risultati in base alle aree di parcheggio situate a meno di 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. Utilizzeremo questa posizione nella prossima parte, dove effettueremo una richiesta all'API Direzione.
Richiesta all'API Directions
Per trovare il percorso dalla stazione a un'area di parcheggio vicino a Notre Dame, devi effettuare una richiesta all'API Directions. Basta impostare i parametri di origine e destinazione. Per scoprire di più, 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 Direction in genere contiene più suggerimenti di percorso. Ogni percorso è costituito da più "tratte", che contengono più "passaggi" che mostrano la distanza e le coordinate del viaggio. Per trovare le coordinate finali raggiungibili con un'auto, utilizza il campo "end_location" dell'ultimo passaggio di un ultimo tratto di un percorso selezionato.
Questa posizione potrebbe non sembrare la prima scelta, ma se guardi la mappa o Google Street View, scoprirai che si trova a breve distanza a piedi da Notre Dame, circa 6-7 minuti.
Percorso a piedi dall'area di parcheggio a Notre-Dame
Riepilogo dell'esempio 1
Come puoi vedere, trovare un'area di parcheggio per un'auto richiede solo alcune chiamate API e la visualizzazione del suggerimento al conducente. In questo modo, gli utenti risparmiano tempo perché non devono guidare su strade a senso unico o cercare un posto dove lasciare l'auto in un'attrazione turistica affollata. In sintesi, abbiamo effettuato le seguenti richieste API:
- Una richiesta all'API Places per trovare le coordinate di Notre Dame
- Una richiesta all'API Places per trovare un'area di parcheggio entro 300 metri da queste coordinate
- Una richiesta all'API Directions per trovare un percorso per raggiungere 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 è necessario un tempo considerevole per spostarsi da un terminale all'altro se si arriva nella posizione sbagliata. 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 Heathrow di Londra (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 riportata sopra fornisce un elenco dei terminali e dei singoli punti di consegna in questi terminali. Nell'elenco dei risultati possiamo trovare "Terminal 5 dell'aeroporto di Londra Heathrow" e il relativo ID luogo:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Utilizzando il parametro "place_id", possiamo comunicare all'API Directions che stiamo tentando di raggiungere un luogo anziché alcune coordinate arbitrarie.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Anche in questo caso, come nell'esempio precedente, leggendo tutti i passaggi della risposta JSON troverai l'ultima parte del tragitto e le coordinate lat e long delle località di destinazione (51.47079979999999,-0.4896765).
Riepilogo dell'esempio 2
Come nell'esempio precedente, lo sforzo di sviluppo per fornire indicazioni migliori al conducente è molto ridotto e i vantaggi in termini di tempo risparmiato per il conducente sono facilmente misurabili. Abbiamo effettuato le seguenti richieste:
- Una richiesta all'API Places per trovare l'aeroporto di Heathrow
- Una richiesta all'API Places per trovare tutti i terminal vicino alle coordinate dell'aeroporto di Heathrow
- Una richiesta all'API Directions per ottenere un percorso per il terminal 5
Conclusione
Come puoi vedere, l'impegno di sviluppo necessario per fornire un servizio premium ai tuoi clienti che viaggiano in auto è piuttosto ridotto e ti consente di dimostrare facilmente quanto tieni alle esigenze dei tuoi clienti.
Per scopi di sviluppo, puoi utilizzare molte delle librerie e degli strumenti disponibili per aiutarti a creare i servizi per i tuoi clienti. Dai un'occhiata al nostro repository GitHub per la piattaforma Google Maps, disponibile pubblicamente.
Azioni successive
- Passaggio dalla navigazione all'aperto a quella al chiuso
- Creare la funzionalità di convalida della posizione con Google Maps
Autore principale
Mikko Toivanen | Solutions Engineer di Google Maps Platform