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 in 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

Mostreremo come utilizzare l'API Places e l'API Directions in sequenza o in combinazione per identificare il luogo giusto dove parcheggiare vicino alla destinazione. Questa soluzione mira a eliminare l'incertezza e le interazioni multiple per trovare un posto dove parcheggiare mentre guidi 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 posizione non direttamente collegata al ciglio della strada in modo che una route debba essere recuperata 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 dell'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.
![]() |
![]() |
In qualità di sviluppatore o fornitore di servizi, è consigliabile chiedere automaticamente all'autista "Cerchi parcheggio vicino a Notre Dame?". L'esperienza utente sarà diversa a seconda del dispositivo e dello schermo, ma in questo caso potrebbe essere utile 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 di testo dell'API Places con i parametri tipo "parcheggio" e raggio "300" impostati. Questo esempio orienterà i risultati verso le 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 dell'API Directions.
Richiesta API Directions
Per trovare il percorso dalla stazione a un parcheggio vicino a Notre Dame, devi inviare una richiesta all'API Directions. Basta 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 di 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, vedrai 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, i tuoi 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 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 ci fornisce un elenco dei terminal e dei singoli punti di consegna 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 lat. e long. 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 all'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