Questo prodotto è in stato legacy. A partire da ottobre 2026, l'API Directions (legacy) non potrà più essere abilitata per i nuovi progetti Google Cloud. I progetti esistenti continuano a essere completamente supportati. Per nuove funzionalità e prestazioni migliorate, esegui la migrazione all'API Routes.
Esempi di richieste
La seguente richiesta restituisce le indicazioni stradali da Toronto, Ontario, a Montreal, Quebec.
URL
https://maps.googleapis.com/maps/api/directions/json?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'
Modificando i parametri mode e avoid, la richiesta iniziale può essere modificata in modo da restituire le indicazioni stradali per un percorso panoramico in bicicletta che eviti le autostrade principali.
URL
https://maps.googleapis.com/maps/api/directions/json ?avoid=highways &destination=Montreal &mode=bicycling &origin=Toronto &key=YOUR_API_KEYYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'
La seguente richiesta cerca le indicazioni per il trasporto pubblico da Brooklyn, New York,
a Queens, New York. La richiesta non specifica un valore departure_time, pertanto l'orario di partenza viene impostato sull'orario corrente:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'
La seguente richiesta di trasporto pubblico include un orario di partenza specifico.
Nota: in questo esempio l'orario di partenza è specificato come 30 luglio 2012 alle 09:45. Per evitare un errore, devi modificare il parametro impostando un orario futuro prima di inviare la richiesta.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=1343641500 &destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'
La seguente richiesta utilizza i Plus Code per restituire le indicazioni stradali da H8MW+WP a GCG2+3M a Calcutta, in India.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=GCG2%2B3M%20Kolkata%20India &origin=H8MW%2BWP%20Kolkata%20India &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'
La seguente richiesta restituisce le indicazioni stradali da Glasgow, Regno Unito, a Perth, Regno Unito, utilizzando gli ID luogo.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE &keyYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'
Modalità di viaggio
Quando calcoli le indicazioni stradali, puoi specificare il mezzo di trasporto mode da utilizzare. Per impostazione predefinita, le indicazioni stradali vengono calcolate come indicazioni stradali driving. Sono supportate le seguenti modalità di viaggio:
driving(predefinito) indica le indicazioni stradali standard che utilizzano la rete stradale.walkingrichiede indicazioni a piedi tramite percorsi pedonali e marciapiedi (se disponibili).bicyclingrichiede indicazioni in bicicletta tramite piste ciclabili e strade preferite (se disponibili).transitrichiede indicazioni stradali tramite percorsi di trasporto pubblico (se disponibili). Se imposti la modalità sutransit, puoi facoltativamente specificaredeparture_timeoarrival_time. Se non viene specificato nessuno dei due orari,departure_timeviene impostato per impostazione predefinita su ora (ovvero l'orario di partenza viene impostato per impostazione predefinita sull'ora corrente). Se vuoi, puoi anche includere untransit_modee/o untransit_routing_preference.
Nota: a volte le indicazioni stradali per gli spostamenti a piedi e in bicicletta potrebbero non includere percorsi pedonali o ciclabili chiari, pertanto queste indicazioni restituiranno warnings nel risultato restituito, che devi mostrare all'utente.
Informazioni sul traffico
Le informazioni sul traffico vengono utilizzate quando si applicano tutte le seguenti condizioni (queste sono le condizioni necessarie per ricevere il campo
duration_in_traffic nella risposta di Directions):
- Il parametro
travel
modeèdrivingo non è specificato (drivingè la modalità di viaggio predefinita). - La richiesta include un
parametro
departure_timevalido. Il valoredeparture_timepuò essere impostato sull'ora corrente o su un'ora futura. Non può essere nel passato. - La richiesta non include waypoint di sosta. Se la richiesta include tappe, aggiungi il prefisso
via:a ogni tappa per influenzare il percorso, ma evita le soste. Ad esempio,&waypoints=via:San Francisco|via:Mountain View|...
Se vuoi, puoi includere il parametro
traffic_model nella richiesta per specificare le ipotesi da utilizzare per il calcolo del tempo nel traffico.
Il seguente URL avvia una richiesta di indicazioni stradali per un viaggio da Boston, MA, a Concord, MA, passando per Charlestown e Lexington. La richiesta include un orario di partenza, che soddisfa tutti i requisiti per restituire il campo duration_in_traffic nella risposta di Directions.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=now &destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'
Waypoint
Quando calcoli i percorsi utilizzando l'API Directions (Legacy), puoi specificare i waypoint per restituire un percorso che includa passaggi o soste in località intermedie. Puoi aggiungere waypoint alle indicazioni stradali per auto, a piedi o in bicicletta, ma non alle indicazioni per il trasporto pubblico.
Specifica le località nel parametro waypoints.
Puoi fornire una o più località separate dal carattere pipe (| o %7C), sotto forma di ID luogo, indirizzo o coordinate di latitudine/longitudine. Per impostazione predefinita, il servizio Directions calcola un percorso utilizzando i waypoint nell'ordine in cui vengono forniti. La precedenza per l'analisi del valore del waypoint è l'ID luogo, le coordinate di latitudine/longitudine e poi l'indirizzo.
- Se passi un ID luogo, devi anteporre il prefisso
place_id:. Puoi recuperare gli ID luogo dall'API Geocoding e dall'API Places (incluso Place Autocomplete). Per un esempio che utilizza gli ID luogo di Place Autocomplete, consulta Place Autocomplete e Directions. Per saperne di più sugli ID luogo, consulta la panoramica degli ID luogo.Per una maggiore efficienza e precisione, utilizza gli ID luogo, se possibile. Questi ID sono espliciti in modo univoco, come una coppia di valori di latitudine/longitudine, e offrono vantaggi di geocodifica per il routing, come punti di accesso e variabili di traffico. A differenza di un indirizzo, gli ID non richiedono al servizio di eseguire una ricerca o una richiesta intermedia per i dettagli dei luoghi, pertanto le prestazioni sono migliori.
- Se passi le coordinate di latitudine/longitudine, i valori vengono inviati direttamente al server frontend per calcolare le indicazioni stradali senza geocodifica. I punti vengono posizionati sulle strade e potrebbero non fornire la precisione richiesta dalla tua app. Utilizza le coordinate quando hai la certezza che i valori specifichino effettivamente i punti necessari alla tua app per il routing, indipendentemente da possibili punti di accesso o dettagli di geocodifica aggiuntivi. Assicurati che i valori di latitudine e longitudine siano separati da una virgola (
%2C) e non da uno spazio (%20). - Se passi un indirizzo, il servizio Directions geocodifica la stringa e la converte in coordinate di latitudine/longitudine per calcolare le indicazioni stradali. Se il valore dell'indirizzo è ambiguo, potrebbe attivare una ricerca per disambiguare indirizzi simili. Ad esempio, "1st Street" potrebbe essere un valore completo o un valore parziale per "1st street NE" o "1st St SE". Questo risultato potrebbe essere diverso da quello restituito dall'API Geocoding. Puoi evitare possibili interpretazioni errate utilizzando gli ID luogo. Consulta la sezione Risoluzione dei problemi relativi ai risultati della richiesta di percorso.
In alternativa, puoi fornire un insieme di punti codificati utilizzando l'algoritmo della polilinea codificata. Un set codificato è utile per un numero elevato di waypoint, perché l'URL è notevolmente più breve. Tutti i servizi web hanno un limite di 16.384 caratteri per gli URL.
- Le polilinee codificate devono essere precedute dal prefisso
enc:e seguite da due punti (:). Ad esempio:waypoints=enc:gfo}EtohhU:. - Puoi anche includere più polilinee codificate, separate dal carattere barra verticale (
|). Ad esempio,waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:
Il seguente URL avvia una richiesta di indicazioni stradali per un viaggio tra Boston, MA e Concord, MA, con tappe a Charlestown e Lexington, in quest'ordine. L'esempio utilizza gli indirizzi:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
Influenza i percorsi con punti di sosta e di passaggio
Per ogni waypoint nella richiesta, la risposta delle indicazioni stradali aggiunge una voce all'array legs per fornire i dettagli delle tappe in quella tratta del percorso.
Se vuoi influenzare il percorso utilizzando i waypoint senza aggiungere una sosta, aggiungi il prefisso via: al waypoint. I waypoint con prefisso via: non aggiungono una voce all'array legs, ma indirizzano il percorso attraverso il waypoint.
Il seguente URL modifica la richiesta precedente in modo che il percorso venga instradato attraverso Lexington senza fermate:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
Il prefisso via: è più efficace quando si creano percorsi in risposta al trascinamento dei waypoint sulla mappa da parte dell'utente. In questo modo, l'utente può vedere l'aspetto del percorso finale in tempo reale e assicurarsi che i waypoint siano posizionati in luoghi accessibili all'API Directions (Legacy).
Il seguente URL richiede waypoint utilizzando le coordinate di latitudine/longitudine:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'
Ecco la stessa richiesta, utilizzando una polilinea codificata:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
Tieni presente che puoi combinare liberamente un identificatore via: con i modificatori di località.
Ad esempio:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
Ottimizza i waypoint
Per impostazione predefinita, il servizio Directions calcola un percorso attraverso i waypoint forniti nell'ordine indicato. Se vuoi, puoi passare optimize:true come primo argomento all'interno del parametro waypoints per consentire al servizio Directions di ottimizzare il percorso fornito riorganizzando i waypoint in un ordine più efficiente. Questa ottimizzazione è un'applicazione del
problema del commesso viaggiatore. Il tempo di percorrenza è il fattore principale che viene ottimizzato, ma per decidere quale percorso è più efficiente possono essere presi in considerazione altri fattori, come la distanza, il numero di svolte e molti altri. Tutti i waypoint devono essere tappe intermedie affinché il servizio Directions possa ottimizzare il percorso.
Se indichi al servizio Directions di ottimizzare l'ordine dei waypoint, l'ordine verrà restituito nel campo waypoint_order all'interno dell'oggetto routes.
Il campo waypoint_order restituisce valori basati su zero.
L'esempio seguente calcola un viaggio su strada da Adelaide, nell'Australia Meridionale, a ciascuna delle principali regioni vinicole dell'Australia Meridionale utilizzando l'ottimizzazione del percorso.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Adelaide%2C%20SA &origin=Adelaide%2C%20SA &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'
L'ispezione del percorso calcolato indicherà che il calcolo utilizza i waypoint nel seguente ordine:
"waypoint_order": [ 3, 2, 0, 1 ]
Limitazioni
Le indicazioni stradali possono essere calcolate in base a determinate limitazioni. Le limitazioni sono indicate dall'utilizzo del parametro avoid e da un argomento di questo parametro che indica la limitazione da evitare. Sono supportate le seguenti limitazioni:
avoid=tollsavoid=highwaysavoid=ferries
È possibile richiedere un percorso che eviti qualsiasi combinazione di pedaggi, autostrade e traghetti passando entrambe le limitazioni al parametro avoid. Ad esempio:
avoid=tolls|highways|ferries.
Nota: l'aggiunta di limitazioni non preclude i percorsi che includono la caratteristica limitata, ma indirizza il risultato verso percorsi più favorevoli.
Sistemi di unità di misura
I risultati delle indicazioni stradali contengono campi text all'interno di distance che possono essere mostrati all'utente per indicare la distanza di un determinato "passaggio" del percorso. Per impostazione predefinita, questo testo utilizza il sistema di unità di misura del paese o della regione di origine.
Ad esempio, un percorso da "Chicago, IL" a "Toronto, ONT" mostrerà i risultati in miglia, mentre il percorso inverso mostrerà i risultati in chilometri. Puoi
eseguire l'override di questo sistema di unità impostandone uno in modo esplicito nel
parametro units della richiesta, passando uno dei seguenti
valori:
metricspecifica l'utilizzo del sistema metrico decimale. Le distanze testuali vengono restituite in chilometri e metri.imperialspecifica l'utilizzo del sistema imperiale (inglese). Le distanze testuali vengono restituite in miglia e piedi.
Nota : questa impostazione del sistema di unità di misura influisce solo sulle text visualizzate nei campi distance. I campi distance contengono anche values, che sono sempre espressi in metri.
Bias della regione
Puoi impostare il servizio Directions in modo che restituisca i risultati di una regione specifica utilizzando il parametro region. Questo parametro accetta un argomento ccTLD (dominio di primo livello nazionale) di due caratteri che specifica l'influenza della regione. La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1 alpha-2, con alcune eccezioni degne di nota.
Ad esempio, il ccTLD del Regno Unito è "uk " (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord"). Per le regioni supportate, consulta i dettagli sulla copertura di Google Maps Platform.
Puoi utilizzare qualsiasi dominio in cui l'applicazione Google Maps principale ha lanciato le indicazioni stradali.
Ad esempio, una richiesta di indicazioni stradali da "Toledo" a "Madrid"
restituisce risultati appropriati quando region è impostato su es
e "Toledo" viene quindi interpretato come la città spagnola:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo ®ion=es &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 40.4165207, "lng": -3.7026134 }, "southwest": { "lat": 39.862808, "lng": -4.029406799999999 }, }, "copyrights": "Map data ©2022 Inst. Geogr. Nacional", "legs": [ { "distance": { "text": "74.3 km", "value": 74327 }, "duration": { "text": "57 mins", "value": 3446 }, "end_address": "Madrid, Spain", "end_location": { "lat": 40.4165207, "lng": -3.705076 }, "start_address": "Toledo, Spain", "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "steps": [ { "distance": { "text": "0.6 km", "value": 615 }, "duration": { "text": "2 mins", "value": 106 }, "end_location": { "lat": 39.8681019, "lng": -4.029378299999999 }, "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>", "polyline": { "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC", }, "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, ], "overview_polyline": { "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)", }, "summary": "A-42", "warnings": [], "waypoint_order": [], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>A-42</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>39.8681019</lat> <lng>-4.0293783</lng> </end_location> <polyline> <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points> </polyline> <duration> <value>106</value> <text>2 mins</text> </duration> <html_instructions>Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b></html_instructions> <distance> <value>615</value> <text>0.6 km</text> </distance> </step> <!-- Additional steps omitted for brevity --> <duration> <value>3446</value> <text>57 mins</text> </duration> <distance> <value>74327</value> <text>74.3 km</text> </distance> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>40.4165207</lat> <lng>-3.7050760</lng> </end_location> <start_address>Toledo, Spain</start_address> <end_address>Madrid, Spain</end_address> </leg> <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights> <overview_polyline> <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points> </overview_polyline> <bounds> <southwest> <lat>39.8628080</lat> <lng>-4.0294068</lng> </southwest> <northeast> <lat>40.4165207</lat> <lng>-3.7026134</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
Una richiesta di indicazioni stradali da "Toledo" a "Madrid" inviata senza un parametro region non restituisce risultati, perché "Toledo" viene interpretata come la città dell'Ohio e non della Spagna:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [], "status": "ZERO_RESULTS", }
XML
<DirectionsResponse> <status>ZERO_RESULTS</status> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
Modificatori dei luoghi
Puoi utilizzare i modificatori di località per indicare in che modo i conducenti devono avvicinarsi a una determinata località, utilizzando il parametro side_of_road per specificare quale lato della strada utilizzare o specificando un'intestazione per indicare la direzione di marcia corretta. Questi modificatori possono essere combinati liberamente con il modificatore via: per i waypoint intermedi.
Specifica che i percorsi devono passare attraverso un lato specifico della strada
Quando specifichi un waypoint, puoi richiedere che il percorso passi attraverso il lato della strada verso cui è orientato il waypoint utilizzando il prefisso side_of_road:. Ad esempio, questa richiesta di indicazioni stradali restituirà un percorso lungo in modo che il veicolo termini sul lato della strada verso cui è stato orientato il waypoint:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=side_of_road%3A37.7663444%2C-122.4412006 &origin=37.7680296%2C-122.4375126 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'
Quando utilizzi side_of_road: con polilinee codificate, il parametro viene applicato a ogni località lungo la polilinea.
Il modificatore side_of_road: può essere utilizzato solo con le seguenti
restrizioni:
- Il parametro
travel
modeèdrivingo non è specificato (drivingè la modalità di viaggio predefinita).
Specifica che i percorsi devono avere una direzione particolare
Quando specifichi un waypoint, puoi richiedere che il percorso lo attraversi in una determinata direzione. Questa direzione è specificata con il prefisso heading=X:, dove X è un valore intero in gradi compreso tra 0 (incluso) e 360 (escluso). Un'intestazione pari a 0 indica il nord, 90 indica l'est e così via in senso orario. Ad esempio, in questa richiesta di indicazioni stradali, il percorso va verso est dall'origine, poi fa un'inversione a U:
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=37.773245%2C-122.469502 &origin=heading%3D90%3A37.773279%2C-122.468780 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'
Il modificatore heading=X: può essere utilizzato solo con le seguenti limitazioni:
- Il parametro di viaggio
modeèdriving,bicyclingo non è specificato (drivingè la modalità di viaggio predefinita). - Il modificatore
side_of_roadnon è specificato per la stessa località. - La località è specificata con un valore di latitudine/longitudine. Non puoi utilizzare
headingcon indirizzi, ID luogo o polilinee codificate.