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 rimangono completamente supportati. Per nuove funzionalità e prestazioni migliorate, esegui la migrazione all'API Routes.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Risposte di indicazioni stradali

Sviluppatori dello Spazio economico europeo (SEE)

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.

Risposte di esempio

Le risposte di Directions vengono restituite nel formato indicato dal flag output all'interno del percorso della richiesta dell'URL.

Di seguito è riportata una richiesta HTTP di esempio che calcola il percorso da Chicago, Illinois, a Los Angeles, California, tramite due waypoint a Joplin, Missouri, e Oklahoma City, Oklahoma.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

L'esempio precedente richiede l'output JSON. È anche possibile richiedere l'output XML. Seleziona le schede di seguito per visualizzare le risposte JSON e XML di esempio.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Il resto di questa documentazione utilizzerà la sintassi JSON. Nella maggior parte dei casi, il formato di output non è importante ai fini dell'illustrazione di concetti o nomi di campi nella documentazione. Tuttavia, tieni presente le seguenti sottili differenze:

I risultati XML sono racchiusi in un elemento root <DirectionsResponse>.
JSON indica le voci con più elementi tramite array plurali (come steps e legs), mentre XML le indica utilizzando più elementi singolari (come <step> e <leg>).
JSON indica l'ordine dei waypoint tramite il campo waypoint_order, mentre XML li indica utilizzando singoli elementi <waypoint_index>.
Gli elementi vuoti sono indicati tramite array vuoti in JSON, ma dall'assenza di un elemento di questo tipo in XML. Ad esempio, una risposta che non genera risultati restituirà un array routes vuoto in JSON, ma nessun elemento <route> in XML.

DirectionsResponse

Campo	Obbligatorio	Tipo	Descrizione
`routes`	required	Array<DirectionsRoute>	Contiene un array di percorsi dal luogo di partenza alla destinazione. I percorsi sono costituiti da tappe e passaggi nidificati. Per saperne di più, consulta DirectionsRoute.
`status`	required	DirectionsStatus	Contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a individuare il motivo per cui la richiesta non è andata a buon fine. Per saperne di più, consulta DirectionsStatus.
`available_travel_modes`	facoltativo	Array<TravelMode>	Contiene un array di modalità di viaggio disponibili. Questo campo viene restituito quando una richiesta specifica una modalità di viaggio e non ottiene risultati. L'array contiene le modalità di viaggio disponibili nei paesi dell'insieme di waypoint specificato. Questo campo non viene restituito se uno o più waypoint sono "waypoint intermedi". Per saperne di più, consulta TravelMode.
`error_message`	facoltativo	stringa	Quando il servizio restituisce un codice di stato diverso da `OK`, potrebbe essere presente un campo `error_message` aggiuntivo all'interno dell'oggetto della risposta. Questo campo contiene informazioni più dettagliate sui motivi alla base del codice di stato specificato. Questo campo non viene sempre restituito e i suoi contenuti sono soggetti a modifiche.
`geocoded_waypoints`	facoltativo	Array<DirectionsGeocodedWaypoint>	Contiene un array con i dettagli sulla geocodifica di origine, destinazione e tappe. Gli elementi nell'array geocoded_waypoints corrispondono, in base alla loro posizione con indice in base zero, all'origine, ai waypoint nell'ordine in cui sono specificati e alla destinazione. Questi dettagli non saranno presenti per i waypoint specificati come valori di latitudine/longitudine testuali se il servizio non restituisce risultati. Questo perché questi waypoint vengono sottoposti a geocodifica inversa per ottenere l'indirizzo rappresentativo solo dopo che è stato trovato un percorso. Un oggetto JSON vuoto occuperà le posizioni corrispondenti nell'array geocoded_waypoints. Per ulteriori informazioni, consulta DirectionsGeocodedWaypoint.

DirectionsRoute

Le route sono costituite da legs e steps nidificati.

Campo	Obbligatorio	Tipo	Descrizione
`bounds`	required	Limiti	Contiene il riquadro di delimitazione dell'area visibile di `overview_polyline`. Per saperne di più, consulta Limiti.
`copyrights`	required	stringa	Contiene le note sul copyright da visualizzare per questo percorso. Devi gestire e visualizzare queste informazioni autonomamente. Questo contenuto deve essere letto così com'è. Non analizzare in modo programmatico questo contenuto di sola visualizzazione.
`legs`	required	Array<DirectionsLeg>	Un array che contiene informazioni su una tappa del percorso, tra due località all'interno del percorso specificato. Sarà presente una tratta separata per ogni waypoint o destinazione specificata. Un percorso senza tappe conterrà esattamente una tratta all'interno dell'array legs. Ogni tappa è costituita da una serie di passaggi. Per saperne di più, consulta DirectionsLeg.
`overview_polyline`	required	DirectionsPolyline	Contiene un oggetto che contiene una rappresentazione della polilinea codificata del percorso. Questa polilinea è un percorso approssimativo (smussato) delle indicazioni stradali risultanti. Per saperne di più, consulta DirectionsPolyline.
`summary`	required	stringa	Contiene una breve descrizione testuale del percorso, adatta per assegnare un nome e distinguere il percorso dalle alternative.
`warnings`	required	Array<string>	Contiene un array di avvisi da mostrare quando vengono visualizzate queste indicazioni stradali. Devi gestire e visualizzare questi avvisi autonomamente.
`waypoint_order`	required	Array<integer>	Un array che indica l'ordine di eventuali tappe nel percorso calcolato. Questi waypoint possono essere riordinati se alla richiesta è stato passato optimize:true all'interno del parametro waypoints.
`fare`	facoltativo	Tariffa	Se presente, contiene la tariffa totale (ovvero i costi totali dei biglietti) per questo percorso. Questa proprietà viene restituita solo per le richieste di trasporto pubblico e solo per i percorsi per i quali sono disponibili informazioni sulle tariffe per tutte le tratte del trasporto pubblico. Per saperne di più, consulta Tariffa.

Limiti

Un rettangolo in coordinate geografiche dai punti negli angoli sud-ovest e nord-est.

Campo	Obbligatorio	Tipo	Descrizione
`northeast`	required	LatLngLiteral	Per saperne di più, consulta LatLngLiteral.
`southwest`	required	LatLngLiteral	Per saperne di più, consulta LatLngLiteral.

LatLngLiteral

Un oggetto che descrive una località specifica con latitudine e longitudine in gradi decimali.

Campo	Obbligatorio	Tipo	Descrizione
`lat`	required	numero	Latitudine in gradi decimali
`lng`	required	numero	Longitudine in gradi decimali

DirectionsLeg

Campo	Obbligatorio	Tipo	Descrizione
`end_address`	required	stringa	Contiene l'indirizzo leggibile (in genere un indirizzo stradale) ottenuto dalla geocodifica inversa del `end_location` di questa tappa. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico.
`end_location`	required	LatLngLiteral	Le coordinate di latitudine/longitudine della destinazione specificata di questa tappa. Poiché l'API Directions calcola le indicazioni stradali tra le località utilizzando l'opzione di trasporto più vicina (di solito una strada) nei punti di partenza e di arrivo, `end_location` potrebbe essere diverso dalla destinazione fornita per questa tappa se, ad esempio, non c'è una strada vicino alla destinazione. Per saperne di più, consulta LatLngLiteral.
`start_address`	required	stringa	Contiene l'indirizzo leggibile (in genere un indirizzo stradale) risultante dalla geocodifica inversa della `start_location` di questa tappa. Questi contenuti devono essere letti così come sono. Non analizzare l'indirizzo formattato in modo programmatico.
`start_location`	required	LatLngLiteral	Le coordinate di latitudine/longitudine dell'origine di questa tratta. Poiché l'API Directions calcola le indicazioni stradali tra le località utilizzando l'opzione di trasporto più vicina (di solito una strada) nei punti di partenza e di arrivo, `start_location` potrebbe essere diverso dall'origine fornita di questa tappa se, ad esempio, non c'è una strada vicino all'origine. Per saperne di più, consulta LatLngLiteral.
`steps`	required	Array<DirectionsStep>	Un array di passaggi che indicano le informazioni su ogni singolo passaggio della tappa del percorso. Per saperne di più, consulta DirectionsStep.
`traffic_speed_entry`	facoltativo	Array<DirectionsTrafficSpeedEntry>	Deprecato: questo array è sempre vuoto. Informazioni sulla velocità del traffico lungo la tappa. Per saperne di più, consulta DirectionsTrafficSpeedEntry.
`via_waypoint`	required	Array<DirectionsViaWaypoint>	Le località dei waypoint di passaggio lungo questa tappa. Per saperne di più, consulta DirectionsViaWaypoint.
`arrival_time`	facoltativo	TimeZoneTextValueObject	Contiene l'orario di arrivo stimato per questa tappa. Questa proprietà viene restituita solo per le indicazioni per il trasporto pubblico. Per saperne di più, consulta TimeZoneTextValueObject.
`departure_time`	facoltativo	TimeZoneTextValueObject	Contiene l'orario di partenza stimato per questa tappa, specificato come oggetto Time. Il campo `departure_time` è disponibile solo per le indicazioni per il trasporto pubblico. Per saperne di più, consulta TimeZoneTextValueObject.
`distance`	facoltativo	TextValueObject	La distanza totale coperta da questa tappa. Per saperne di più, consulta TextValueObject.
`duration`	facoltativo	TextValueObject	La durata totale di questa tappa. Per saperne di più, consulta TextValueObject.
`duration_in_traffic`	facoltativo	TextValueObject	Indica la durata totale di questa tappa. Questo valore è una stima del tempo nel traffico in base alle condizioni del traffico attuali e storiche. Consulta il parametro di richiesta `traffic_model` per le opzioni che puoi utilizzare per richiedere che il valore restituito sia ottimistico, pessimistico o una stima approssimativa. La durata nel traffico viene restituita solo se sono soddisfatte tutte le seguenti condizioni: La richiesta non include waypoint di sosta. Se la richiesta include tappe, queste devono essere precedute dal prefisso `via:` per evitare soste. La richiesta riguarda specificamente le indicazioni stradali: il parametro mode è impostato su `driving`. La richiesta include un parametro `departure_time`. Le condizioni del traffico sono disponibili per il percorso richiesto. Per saperne di più, consulta TextValueObject.

DirectionsStep

Ogni elemento nell'array steps definisce un singolo passaggio delle indicazioni stradali calcolate. Un passaggio è l'unità più atomica di un percorso di indicazioni stradali e contiene un singolo passaggio che descrive un'istruzione specifica e singola sul percorso. Ad esempio "Svolta a sinistra in W. 4th St." Il passaggio non solo descrive l'istruzione, ma contiene anche informazioni sulla distanza e sulla durata relative alla relazione tra questo passaggio e quello successivo. Ad esempio, un passaggio indicato come "Immettiti sulla I-80 West" può contenere una durata di "37 miglia" e "40 minuti", a indicare che il passaggio successivo si trova a 37 miglia/40 minuti da questo passaggio.

Quando utilizzi l'API Directions per cercare indicazioni per il trasporto pubblico, l'array steps includerà dettagli aggiuntivi sul trasporto pubblico sotto forma di array transit_details. Se le indicazioni stradali includono più modalità di trasporto, verranno fornite indicazioni stradali dettagliate per i passaggi a piedi o in auto in un array di passaggi interni. Ad esempio, un passaggio a piedi includerà le indicazioni stradali dalle località di partenza e di arrivo: "Cammina fino a Innes Ave & Fitch St". Questo passaggio includerà indicazioni stradali dettagliate per il percorso nell'array di passaggi interni, ad esempio: "Procedi verso nord-ovest", "Svolta a sinistra su Arelious Walker" e "Svolta a sinistra su Innes Ave".

Campo	Obbligatorio	Tipo	Descrizione
`duration`	required	TextValueObject	Contiene il tempo tipico necessario per eseguire il passaggio, fino al passaggio successivo. Questo campo potrebbe non essere definito se la durata è sconosciuta. Per saperne di più, consulta TextValueObject.
`end_location`	required	LatLngLiteral	Contiene la posizione dell'ultimo punto di questo passaggio. Per saperne di più, consulta LatLngLiteral.
`html_instructions`	required	stringa	Contiene istruzioni formattate per questo passaggio, presentate come stringa di testo HTML. Questi contenuti devono essere letti così come sono. Non analizzare in modo programmatico questi contenuti di sola visualizzazione.
`polyline`	required	DirectionsPolyline	Contiene un singolo oggetto points che contiene una rappresentazione della polyline codificata del passaggio. Questa polilinea è un percorso approssimativo (smussato) del passaggio. Per saperne di più, consulta DirectionsPolyline.
`start_location`	required	LatLngLiteral	Contiene la posizione del punto di partenza di questo passaggio. Per saperne di più, consulta LatLngLiteral.
`travel_mode`	required	TravelMode	Contiene il tipo di modalità di viaggio utilizzata. Per saperne di più, consulta TravelMode.
`distance`	facoltativo	TextValueObject	Contiene la distanza coperta da questo passaggio fino al passaggio successivo. Questo campo potrebbe non essere definito se la distanza è sconosciuta. Per saperne di più, consulta TextValueObject.
`maneuver`	facoltativo	stringa	Contiene l'azione da intraprendere per il passaggio corrente (svolta a sinistra, immissione, dritto e così via). I valori sono soggetti a modifiche e potrebbero essere introdotti nuovi valori senza preavviso. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	facoltativo		Contiene indicazioni dettagliate per i passaggi a piedi o in auto nelle indicazioni per il trasporto pubblico. I passaggi secondari sono disponibili solo quando travel_mode è impostato su "transit". L'array steps interno è dello stesso tipo di steps.
`transit_details`	facoltativo	DirectionsTransitDetails	Dettagli relativi a questo passaggio se la modalità di viaggio è `transit`. Per ulteriori informazioni, consulta DirectionsTransitDetails.

TextValueObject

Un oggetto contenente un valore numerico e la relativa rappresentazione testuale formattata.

Campo	Obbligatorio	Tipo	Descrizione
`text`	required	stringa	Valore stringa.
`value`	required	numero	Valore numerico.

DirectionsPolyline

La codifica delle polilinee è un algoritmo di compressione con perdita di dati che consente di memorizzare una serie di coordinate come una singola stringa. Le coordinate dei punti sono codificate utilizzando valori con segno. Se hai solo alcuni punti statici, puoi anche utilizzare l'utilità di codifica delle polilinee interattiva.

Il processo di codifica converte un valore binario in una serie di codici di caratteri per i caratteri ASCII utilizzando il noto schema di codifica Base64: per garantire la corretta visualizzazione di questi caratteri, i valori codificati vengono sommati a 63 (il carattere ASCII "?") prima di convertirli in ASCII. L'algoritmo verifica anche la presenza di codici di caratteri aggiuntivi per un determinato punto controllando il bit meno significativo di ogni gruppo di byte; se questo bit è impostato su 1, il punto non è ancora completamente formato e devono seguire dati aggiuntivi.

Inoltre, per risparmiare spazio, i punti includono solo l'offset rispetto al punto precedente (ad eccezione, ovviamente, del primo punto). Tutti i punti sono codificati in Base64 come numeri interi con segno, poiché le latitudini e le longitudini sono valori con segno. Il formato di codifica all'interno di una polilinea deve rappresentare due coordinate che rappresentano la latitudine e la longitudine con una precisione ragionevole. Considerando una longitudine massima di +/- 180 gradi con una precisione di 5 cifre decimali (da 180,00000 a -180,00000), è necessario un valore intero binario con segno a 32 bit.

Campo	Obbligatorio	Tipo	Descrizione
`points`	required	stringa	Una singola rappresentazione di stringa della polilinea.

TravelMode

DRIVING (predefinito) indica il calcolo utilizzando la rete stradale.
BICYCLING richiede il calcolo per la bicicletta utilizzando piste ciclabili e strade preferite (se disponibili).
TRANSIT richiede il calcolo utilizzando i percorsi del trasporto pubblico (se disponibili).
WALKING richiede il calcolo per gli spostamenti a piedi utilizzando percorsi pedonali e marciapiedi (se disponibili).

DirectionsTransitDetails

Informazioni aggiuntive non pertinenti per altre modalità di trasporto.

Campo	Obbligatorio	Tipo	Descrizione
`arrival_stop`	facoltativo	DirectionsTransitStop	La fermata di arrivo. Per saperne di più, consulta DirectionsTransitStop.
`arrival_time`	facoltativo	TimeZoneTextValueObject	Per saperne di più, consulta TimeZoneTextValueObject.
`departure_stop`	facoltativo	DirectionsTransitStop	La fermata del trasporto pubblico di partenza. Per saperne di più, consulta DirectionsTransitStop.
`departure_time`	facoltativo	TimeZoneTextValueObject	Per saperne di più, consulta TimeZoneTextValueObject.
`headsign`	facoltativo	stringa	Specifica la direzione di viaggio su questa linea, come indicato sul veicolo o alla fermata di partenza. Spesso si tratta della stazione capolinea.
`headway`	facoltativo	integer	Specifica il numero previsto di secondi tra le partenze dalla stessa fermata in questo momento. Ad esempio, con un valore `headway` di 600, dovresti aspettarti un'attesa di dieci minuti se dovessi perdere l'autobus.
`line`	facoltativo	DirectionsTransitLine	Contiene informazioni sulla linea di trasporto pubblico utilizzata in questo passaggio. Per saperne di più, consulta DirectionsTransitLine.
`num_stops`	facoltativo	integer	Il numero di fermate dalla fermata di partenza a quella di arrivo. Sono incluse le fermate di arrivo, ma non quelle di partenza. Ad esempio, se le indicazioni stradali prevedono la partenza dalla fermata A, il passaggio per le fermate B e C e l'arrivo alla fermata D, `num_stops` restituirà 3.
`trip_short_name`	facoltativo	stringa	Il testo che appare negli orari e nei cartelli per identificare una corsa per i passeggeri. Il testo deve identificare in modo univoco una corsa all'interno di un giorno di servizio. Ad esempio, "538" è il `trip_short_name` del treno Amtrak che parte da San Jose, CA alle 15:10 nei giorni feriali per Sacramento, CA.

DirectionsTransitStop

Campo	Obbligatorio	Tipo	Descrizione
`location`	required	LatLngLiteral	La posizione della fermata. Per saperne di più, consulta LatLngLiteral.
`name`	required	stringa	Il nome della fermata di trasporto pubblico.

TimeZoneTextValueObject

Un oggetto contenente l'ora epoca di Unix, un fuso orario e la relativa rappresentazione testuale formattata.

Campo	Obbligatorio	Tipo	Descrizione
`text`	required	stringa	L'ora specificata come stringa nel fuso orario.
`time_zone`	required	stringa	Contiene il fuso orario. Il valore è il nome del fuso orario definito nel database dei fusi orari IANA, ad esempio "America/New_York".
`value`	required	numero	L'ora specificata come epoca di Unix o secondi dalla mezzanotte del 1° gennaio 1970 UTC.

DirectionsTransitLine

Campo	Obbligatorio	Tipo	Descrizione
`agencies`	required	Array<DirectionsTransitAgency>	L'azienda di trasporto pubblico (o le aziende) che gestisce questa linea di trasporto pubblico. Per ulteriori informazioni, consulta DirectionsTransitAgency.
`name`	required	stringa	Il nome completo della linea di trasporto pubblico, ad esempio "8 Avenue Local".
`color`	facoltativo	stringa	Il colore di uso comune nella segnaletica per questa linea.
`icon`	facoltativo	stringa	Contiene l'URL dell'icona associata a questa linea.
`short_name`	facoltativo	stringa	Il nome breve di questa linea di trasporto pubblico. In genere si tratta di un numero di linea, ad esempio "M7" o "355".
`text_color`	facoltativo	stringa	Il colore di uso comune nella segnaletica per questa linea.
`url`	facoltativo	stringa	Contiene l'URL della linea di trasporto pubblico fornito dall'azienda di trasporto pubblico.
`vehicle`	facoltativo	DirectionsTransitVehicle	Il tipo di veicolo che opera su questa linea di trasporto pubblico. Per ulteriori informazioni, consulta DirectionsTransitVehicle.

DirectionsTransitAgency

Campo	Obbligatorio	Tipo	Descrizione
`name`	facoltativo	stringa	Il nome di questa azienda di trasporto pubblico.
`phone`	facoltativo	stringa	Il numero di telefono dell'azienda di trasporto pubblico.
`url`	facoltativo	stringa	L'URL dell'azienda di trasporto pubblico.

DirectionsTransitVehicle

Campo	Obbligatorio	Tipo	Descrizione
`name`	required	stringa	Il nome di questo veicolo, con l'iniziale maiuscola.
`type`	required	stringa	Il tipo di veicolo utilizzato. `BUS` - Autobus. `CABLE_CAR`: un veicolo che opera su un cavo, solitamente a terra. Le funivie possono essere del tipo GONDOLA_LIFT. `COMMUTER_TRAIN` - Treno suburbano. `FERRY` - Traghetto. `FUNICULAR`: un veicolo che viene trainato su un pendio ripido da un cavo. Una funicolare è generalmente costituita da due carrozze, ognuna delle quali funge da contrappeso per l'altra. `GONDOLA_LIFT` - Una funivia. `HEAVY_RAIL`: ferrovia pesante. `HIGH_SPEED_TRAIN` - Treno ad alta velocità. `INTERCITY_BUS` - Autobus interurbano. `LONG_DISTANCE_TRAIN` - Treno a lunga percorrenza. `METRO_RAIL` - Metropolitana leggera. `MONORAIL` - Monorotaia. `OTHER`: tutti gli altri veicoli restituiranno questo tipo. `RAIL` - Treno. `SHARE_TAXI` - Il taxi condiviso è un tipo di autobus con la possibilità di far scendere e salire i passeggeri in qualsiasi punto del percorso. `SUBWAY` - Metropolitana leggera sotterranea. `TRAM` - Metropolitana leggera in superficie. `TROLLEYBUS` - Filobus. The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	facoltativo	stringa	Contiene l'URL di un'icona associata a questo tipo di veicolo.
`local_icon`	facoltativo	stringa	Contiene l'URL dell'icona associata a questo tipo di veicolo, in base alla segnaletica di trasporto locale.

DirectionsTrafficSpeedEntry

Campo	Obbligatorio	Tipo	Descrizione
`offset_meters`	required	numero	L'offset lungo il percorso (in metri) fino al quale è valida questa categoria di velocità.
`speed_category`	required	stringa	Le condizioni attuali del traffico/della velocità su questa parte di un percorso.

DirectionsViaWaypoint

Campo	Obbligatorio	Tipo	Descrizione
`location`	facoltativo	LatLngLiteral	La posizione del waypoint. Per saperne di più, consulta LatLngLiteral.
`step_index`	facoltativo	integer	L'indice del passaggio contenente il waypoint.
`step_interpolation`	facoltativo	numero	La posizione del waypoint lungo la polilinea del passaggio, espressa come rapporto da 0 a 1.

Tariffa

La tariffa totale per il percorso.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

Campo	Obbligatorio	Tipo	Descrizione
`currency`	required	stringa	Un codice valuta ISO 4217 che indica la valuta in cui è espresso l'importo.
`text`	required	stringa	L'importo totale della tariffa, formattato nella lingua richiesta.
`value`	required	numero	L'importo totale della tariffa, nella valuta specificata.

DirectionsStatus

Il campo status all'interno dell'oggetto di risposta di Directions contiene lo stato della richiesta e può contenere informazioni di debug per aiutarti a capire perché il servizio Directions non è riuscito. Il campo dello stato può contenere i seguenti valori:

OK indica che la risposta contiene un risultato valido.
NOT_FOUND indica che non è stato possibile geocodificare almeno una delle località specificate nell'origine, nella destinazione o nei waypoint della richiesta.
ZERO_RESULTS indica che non è stato possibile trovare un percorso tra l'origine e la destinazione.
MAX_WAYPOINTS_EXCEEDED indica che nella richiesta sono stati forniti troppi waypoint. Per le applicazioni che utilizzano l'API Directions come servizio web o il servizio di indicazioni stradali nell'API Maps JavaScript, il numero massimo di waypoint consentito è 25, oltre all'origine e alla destinazione.
MAX_ROUTE_LENGTH_EXCEEDED indica che il percorso richiesto è troppo lungo e non può essere elaborato. Questo errore si verifica quando vengono restituite indicazioni più complesse. Prova a ridurre il numero di waypoint, svolte o istruzioni.
INVALID_REQUEST indica che la richiesta fornita non era valida. Le cause comuni di questo stato includono un parametro o un valore parametro non valido.
OVER_DAILY_LIMIT indica una delle seguenti opzioni:
- La chiave API è mancante o non valida.
- La fatturazione non è stata abilitata sul tuo account.
- È stato superato un limite di utilizzo autoimposto.
- Il metodo di pagamento fornito non è più valido (ad esempio, una carta di credito è scaduta).
Consulta le domande frequenti su Maps per scoprire come risolvere il problema.
OVER_QUERY_LIMIT indica che il servizio ha ricevuto troppe richieste dalla tua applicazione entro il periodo di tempo consentito.
REQUEST_DENIED indica che il servizio ha negato l'utilizzo del servizio di indicazioni stradali da parte della tua applicazione.
UNKNOWN_ERROR indica che non è stato possibile elaborare una richiesta di indicazioni stradali a causa di un errore del server. La richiesta potrebbe andare a buon fine se riprovi.

DirectionsGeocodedWaypoint

Campo	Obbligatorio	Tipo	Descrizione
`geocoder_status`	facoltativo	stringa	Indica il codice di stato risultante dall'operazione di geocodifica. Questo campo può contenere i seguenti valori. The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	facoltativo		Indica che il geocodificatore non ha restituito una corrispondenza esatta per la richiesta originale, anche se è stato in grado di trovare una corrispondenza con parte dell'indirizzo richiesto. Ti consigliamo di esaminare la richiesta originale per verificare la presenza di errori ortografici e/o di un indirizzo incompleto. Le corrispondenze parziali si verificano più spesso per gli indirizzi che non esistono all'interno della località che passi nella richiesta. Le corrispondenze parziali possono essere restituite anche quando una richiesta corrisponde a due o più località nella stessa località. Ad esempio, "21 Henr St, Bristol, UK" restituirà una corrispondenza parziale sia per Henry Street sia per Henrietta Street. Tieni presente che se una richiesta include un componente dell'indirizzo con errori ortografici, il servizio di geocodifica potrebbe suggerire un indirizzo alternativo. Anche i suggerimenti attivati in questo modo verranno contrassegnati come corrispondenza parziale.
`place_id`	facoltativo	stringa	Un identificatore univoco che può essere utilizzato con altre API di Google. Consulta la panoramica degli ID luogo.
`types`	facoltativo	Array<string>	Indica il tipo di indirizzo del risultato di geocodifica utilizzato per calcolare le indicazioni stradali. `administrative_area_level_1` indica una divisione amministrativa principale al di sotto del livello paese. Negli Stati Uniti, questi livelli amministrativi sono gli stati. Non tutte le nazioni utilizzano questi livelli amministrativi. Nella maggior parte dei casi, i nomi brevi di administrative_area_level_1 corrispondono esattamente alle suddivisioni ISO 3166-2 e ad altri elenchi ampiamente diffusi. Tuttavia, questo non è garantito, poiché i nostri risultati di geocodifica si basano su una serie di indicatori e dati sulla posizione. `administrative_area_level_2` indica una divisione amministrativa di secondo livello al di sotto del livello paese. Negli Stati Uniti, questi livelli amministrativi sono le contee. Non tutte le nazioni utilizzano questi livelli amministrativi. `administrative_area_level_3` indica una divisione amministrativa di terzo livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi. `administrative_area_level_4` indica una divisione amministrativa di quarto livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni presentano questi livelli amministrativi. `administrative_area_level_5` indica una divisione amministrativa di quinto livello al di sotto del livello paese. Questo tipo indica una divisione civile minore. Non tutte le nazioni utilizzano questi livelli amministrativi. `airport` indica un aeroporto. `colloquial_area` indica un nome alternativo di uso comune per l'entità. `country` indica l'entità politica nazionale ed è in genere il tipo di ordine più elevato restituito dal geocodificatore. `intersection` indica un incrocio importante, di solito tra due strade principali. `locality` indica un'entità politica di una città o un paese incorporato. `natural_feature` indica una caratteristica naturale di rilievo. `neighborhood` indica un quartiere con un nome `park` indica un parco con un nome. `plus_code` indica un riferimento alla località codificato, derivato dalla latitudine e dalla longitudine. I Plus Code possono essere utilizzati in sostituzione degli indirizzi nei luoghi in cui non esistono (dove gli edifici non sono numerati o le strade non hanno un nome). Per i dettagli, visita la pagina https://plus.codes. `point_of_interest` indica un punto d'interesse con nome. In genere, questi "PDI" sono entità locali di rilievo che non rientrano facilmente in un'altra categoria, come "Empire State Building" o "Torre Eiffel". `political` indica un'entità politica. In genere, questo tipo indica un poligono di un'amministrazione civile. `postal_code` indica un codice postale utilizzato per la spedizione della posta tradizionale di un paese. `premise` indica una località con un nome, di solito un edificio o un insieme di edifici con un nome comune `route` indica un percorso con nome (ad esempio "US 101"). `street_address` indica un indirizzo preciso. `sublocality` indica un'entità civile di primo ordine sotto una località. Per alcune località, potresti ricevere uno dei tipi aggiuntivi: sublocality_level_1 fino a sublocality_level_5. Ogni livello di località secondaria è un'entità civile. I numeri più grandi indicano un'area geografica più piccola. `subpremise` indica un'entità di primo ordine sotto una località con nome, in genere un singolo edificio all'interno di un insieme di edifici con un nome comune `tourist_attraction` indica un'attrazione turistica. `train_station` indica una stazione ferroviaria. `transit_station` indica una stazione di transito. Un elenco vuoto di tipi indica che non esistono tipi noti per il componente dell'indirizzo specifico, ad esempio Lieu-dit in Francia.

Risposte di indicazioni stradali Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Risposte di esempio

URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

Limiti

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

Risposte di indicazioni stradali

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`