Esiste una versione più recente di questo documento con esempi di come utilizzare le nuove API Places e API Routes.
In genere, quando l'utente guida verso un punto di interesse, in realtà ha bisogno di indicazioni stradali per una località vicina, ad esempio un parcheggio o un punto di accesso. Immagina un automobilista che deve andare in un aeroporto o in un centro commerciale. Quando si reca in un aeroporto, l'automobilista cerca di raggiungere un terminal o un punto di scarico, 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 l'automobilista, devi prima trovare la località in cui si sta recando e poi offrire all'automobilista destinazioni facoltative nelle vicinanze. Questo approccio ti consente di fornire un servizio migliore ai tuoi clienti e di dimostrare che tieni al 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 l'automobilista verso una località in auto
Ti mostreremo come utilizzare le API Places e API Directions in sequenza o in combinazione per identificare la posizione giusta in cui parcheggiare vicino alla tua destinazione. Questa soluzione mira a eliminare l'incertezza e le interazioni multiple per trovare un posto in cui parcheggiare mentre si guida una volta più vicino 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 un 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'automobilista 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 parcheggio di grandi dimensioni disponibile nelle vicinanze, quindi questa dovrebbe essere una sfida interessante.
Richiesta API Places
Questa richiesta API Places di esempio utilizza la "ricerca testuale" per trovare Notre Dame. Consulta la documentazione per sviluppatori per i dettagli. In questi esempi, "YOUR_KEY" è la chiave API che hai per le API Places e API Directions di Google Maps Platform abilitate nella console Google Cloud. Per una spiegazione più dettagliata, consulta la documentazione per 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.
|
|
In qualità di sviluppatore o fornitore di servizi, è una buona idea chiedere automaticamente all'automobilista "Cerchi 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 un breve periodo di tempo. Per trovare parcheggio vicino a Notre Dame, esegui una ricerca testuale dell'API Places con i parametri type "parking" e radius "300" impostati. Questo esempio indirizzerà i risultati 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" a 48.850591, 2.3486436. Utilizziamo questa località nella parte successiva, in cui eseguiamo una richiesta API Directions.
Richiesta API Directions
Per trovare il percorso dalla stazione a un'area di parcheggio vicino a Notre Dame, devi eseguire una richiesta API Directions. Basta impostare i parametri di origine e destinazione. Per altre opzioni, consulta la documentazione per 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 di percorso. Ogni percorso è composto da più "tratte" e queste contengono più "passaggi" che mostrano la distanza di viaggio e le coordinate. Per trovare le coordinate finali raggiungibili in auto, utilizza il campo "end_location" dell'ultimo passaggio dell'ultima tratta di un percorso selezionato.
Questa località potrebbe non sembrare la prima scelta, ma se guardi la mappa o Google Street View, scoprirai che si trova a una distanza a piedi molto breve, circa 6-7 minuti, da Notre Dame.
Percorso a piedi dall'area di parcheggio a Notre Dame
Riepilogo per l'esempio 1
Come puoi vedere, trovare un'area di parcheggio per un'auto richiede solo alcune chiamate API e la visualizzazione del suggerimento per l'automobilista. In questo modo, gli utenti risparmiano tempo perché non guidano su strade a senso unico o cercano un posto dove lasciare l'auto in un'attrazione turistica affollata. In sintesi, abbiamo eseguito le seguenti richieste API:
- Una richiesta API Places per trovare le coordinate di Notre Dame
- Una richiesta API Places per trovare un'area di parcheggio entro 300 metri da queste coordinate
- Una richiesta API Directions per trovare un percorso per l'area di parcheggio
Esempio 2: indicazioni stradali per 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 trasferirsi tra i terminal se si arriva nella località sbagliata. In questo caso, poiché il tipo di risultato di ricerca è "airport", è utile eseguire automaticamente una query di follow-up per cercare "terminal" utilizzando la località 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 ci fornisce un elenco dei terminal e dei singoli punti di scarico di questi terminal. Nell'elenco dei risultati possiamo trovare "London Heathrow Airport Terminal 5" e il relativo ID luogo:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
Utilizzando il parametro "place_id", possiamo indicare 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
Anche in questo caso, 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à finali (51.47079979999999,-0.4896765).
Riepilogo per l'esempio 2
Come nell'esempio precedente, lo sforzo di sviluppo per fornire indicazioni stradali migliorate all'automobilista è molto piccolo e i vantaggi in termini di tempo risparmiato per l'automobilista sono facilmente misurabili. Abbiamo eseguito le seguenti richieste:
- Una richiesta API Places per trovare l'aeroporto di Heathrow
- Una richiesta API Places per trovare tutti i terminal vicino alle coordinate dell'aeroporto di Heathrow
- Una richiesta 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 che stai pensando alle 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 disponibile pubblicamente disponibile per Google Maps Platform.
Azioni successive
Autore principale
Mikko Toivanen | Ingegnere di soluzioni di Google Maps Platform