Route - Get Route Directions

Servizio:

Maps

Versione API:

1.0

Utilizzare per calcolare una route tra un'origine e una destinazione specificate, passando attraverso qualsiasi punto di percorso specificato.

L'API Get Route Directions è una richiesta http GET che restituisce una route tra un'origine e una destinazione, passando i punti di waypoint, se specificato. Il percorso tiene conto di fattori quali il traffico corrente e le velocità tipiche della strada nel giorno richiesto della settimana e dell'ora del giorno.

Le informazioni restituite includono la distanza, il tempo di viaggio stimato e una rappresentazione della geometria del percorso. Sono disponibili anche informazioni aggiuntive sul routing, ad esempio l'ordine dei punti di ottimizzazione o il turno per turno, a seconda delle opzioni selezionate.

Il servizio di routing fornisce un set di parametri per una descrizione dettagliata di un modello di consumo specifico del veicolo. Per altre informazioni, vedere Modello a consumo.

GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}

Con parametri facoltativi:

GET https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&arriveAt={arriveAt}&departAt={departAt}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings&sectionType={sectionType}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
format	path	True	ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
api-version	query	True	string	Numero di versione dell'API mappe di Azure.
query	query	True	string	Coordinate attraverso cui viene calcolata la route, delimitata da due punti. È necessario un minimo di due coordinate. Il primo è l'origine e l'ultimo è la destinazione della route. Le coordinate facoltative in-between fungono da WayPoints nella route. È possibile passare fino a 150 WayPoint.
accelerationEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia chimica memorizzata nel combustibile in energia cinetica quando il veicolo accelera (ad esempio, CineticaGained/ChemicalBytesConsumed). Il Chemical VaultConsumed viene ottenuto convertendo il combustibile consumato in energia chimica utilizzando fuel VaultDensityInMJoulesPerLiter. Deve essere associato a decelerazioneEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/decelerazioneEfficienza. Valori sensibili: per modello di combustione : 0,33, per modello elettrico : 0,66
alternativeType	query		AlternativeRouteType	Controlla l'ottimalità, in relazione ai criteri di pianificazione specificati, delle alternative calcolate rispetto alla route di riferimento.
arriveAt	query		string date-time	Data e ora di arrivo nel punto di destinazione formattato come valore dateTime definito in RFC 3339, sezione 5.6, con una differenza di fuso orario facoltativa. Quando non viene specificata una differenza di fuso orario, si presuppone che sia quella del punto di destinazione. Esempi: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Il parametro arriveAt non può essere usato insieme a departAt, minDeviationDistance o minDeviationTime.
auxiliaryPowerInkW	query		number double	Specifica la quantità di energia consumata per il mantenimento dei sistemi ausiliari, in kilowatt (kW). Può essere usato per specificare il consumo a causa di dispositivi e sistemi come sistemi AC, radio, riscaldamento e così via. Valori sensibili: 1,7
auxiliaryPowerInLitersPerHour	query		number double	Specifica la quantità di carburante consumata per sostenere sistemi ausiliari del veicolo, in litri all'ora. Può essere usato per specificare il consumo a causa di dispositivi e sistemi come sistemi AC, radio, riscaldamento e così via. Valori sensibili: 0,2
avoid	query		RouteAvoidType[]	Specifica un elemento che il calcolo della route deve tentare di evitare quando si determina la route. Può essere specificato più volte in una richiesta, ad esempio "&evitare=autostrade&evitare=tollRoads&evitare=traghetti". Nelle richieste di intervallo di route il valore giàUsedRoads non deve essere usato.
computeBestOrder	query		boolean	Riordinare i punti di percorso usando un algoritmo euristico rapido per ridurre la lunghezza della route. Restituisce risultati migliori quando viene usato insieme a routeType più breve. Si noti che l'origine e la destinazione vengono escluse dagli indici waypoint ottimizzati. Per includere l'origine e la destinazione nella risposta, aumentare tutti gli indici di 1 per tenere conto dell'origine e quindi aggiungere la destinazione come indice finale. I valori possibili sono true o false. True calcola un ordine migliore, se possibile, ma non può essere usato in combinazione con il valore maxAlternatives maggiore di 0 o in combinazione con i punti di direzione del cerchio. False userà le posizioni nell'ordine specificato e non potrà essere usato insieme a routeRepresentation none.
computeTravelTimeFor	query		ComputeTravelTime	Specifica se restituire tempi di viaggio aggiuntivi usando tipi diversi di informazioni sul traffico (none, cronologia, dinamica) e il tempo di viaggio migliore predefinito.
constantSpeedConsumptionInkWhPerHundredkm	query		string	Specifica il componente dipendente dalla velocità del consumo. Fornito come elenco non ordinato di coppie velocità/frequenza di consumo. L'elenco definisce i punti su una curva di consumo. I tassi di consumo per le velocità non presenti nell'elenco sono disponibili nel modo seguente: per interpolazione lineare, se la velocità specificata si trova tra due velocità nell'elenco per estrapolazione lineare in caso contrario, presupponendo una costante (ΔConsumption/ΔSpeed) determinata dai due punti più vicini nell'elenco L'elenco deve contenere tra 1 e 25 punti (inclusi) e potrebbe non contenere punti duplicati per la stessa velocità. Se contiene solo un singolo punto, la velocità di utilizzo di tale punto viene utilizzata senza ulteriori elaborazioni. Il consumo specificato per la velocità massima deve essere maggiore o uguale a quello della penultimo velocità massima. Ciò garantisce che l'estrapolazione non comporti tassi di consumo negativi. Analogamente, i valori di consumo specificati per le due velocità più piccole nell'elenco non possono portare a una velocità di consumo negativa per qualsiasi velocità più piccola. L'intervallo valido per i valori di consumo (espresso in kWh/100km) è compreso tra 0,01 e 100000,0. Valori sensibili: 50.8.2:130,21.3 Questo parametro è obbligatorio per modello di consumo elettrico.
constantSpeedConsumptionInLitersPerHundredkm	query		string	Specifica il componente dipendente dalla velocità del consumo. Fornito come elenco non ordinato di velocità delimitata da due punti & coppie di frequenza di consumo. L'elenco definisce i punti su una curva di consumo. I tassi di consumo per le velocità non presenti nell'elenco sono disponibili nel modo seguente: per interpolazione lineare, se la velocità specificata si trova tra due velocità nell'elenco per estrapolazione lineare in caso contrario, presupponendo una costante (ΔConsumption/ΔSpeed) determinata dai due punti più vicini nell'elenco L'elenco deve contenere tra 1 e 25 punti (inclusi) e potrebbe non contenere punti duplicati per la stessa velocità. Se contiene solo un singolo punto, la velocità di utilizzo di tale punto viene utilizzata senza ulteriori elaborazioni. Il consumo specificato per la velocità massima deve essere maggiore o uguale a quello della penultimo velocità massima. Ciò garantisce che l'estrapolazione non comporti tassi di consumo negativi. Analogamente, i valori di consumo specificati per le due velocità più piccole nell'elenco non possono portare a una velocità di consumo negativa per qualsiasi velocità più piccola. L'intervallo valido per i valori di consumo (espresso in l/100km) è compreso tra 0,01 e 100000,0. Valori sensibili: 50,6,3:130,11,5 Nota : questo parametro è necessario per Modello di consumo della combustione.
currentChargeInkWh	query		number double	Specifica l'alimentazione elettrica corrente in kilowatt ore (kWh). Questo parametro coesiste con parametro maxChargeInkWh. L'intervallo di valori consentiti è compreso tra 0,0 e maxChargeInkWh. Valori sensibili: 43
currentFuelInLiters	query		number double	Specifica l'alimentazione corrente di carburante in litri. Valori sensibili: 55
decelerationEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia cinetica in carburante risparmiato (non consumato) quando il veicolo decelerate (ad esempio ChemicalMakSaved/CinePendioLost). Il Chemical VaultSaved viene ottenuto convertendo il combustibile salvato (non consumato) in energia utilizzando fuel VaultDensityInMJoulesPerLiter. Deve essere associato a accelerazioneEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/accelerazioneEfficienza. Valori sensibili: per modello di combustione : 0,83, per modello elettrico : 0,91
departAt	query		string date-time	Data e ora di partenza dal punto di origine formattato come valore dateTime definito in RFC 3339, sezione 5.6, con una differenza di fuso orario facoltativa. Quando non viene specificata una differenza di fuso orario, si presuppone che sia quella del punto di origine. Valore predefinito: ora Altro valore: dateTime Esempi: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Il parametro departAt non può essere utilizzato insieme a arriveAt.
downhillEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia potenziale in carburante risparmiato (non consumato) quando il veicolo perde l'elevazione (ad esempio ChemicalFoliaSaved/Potential BehalfLost). Il Chemical VaultSaved viene ottenuto convertendo il combustibile salvato (non consumato) in energia utilizzando fuel VaultDensityInMJoulesPerLiter. Deve essere associato a in salita. L'intervallo di valori consentiti è compreso tra 0,0 e 1/l'uphillEfficiency. Valori sensibili: per modello di combustione : 0,51, per modello elettrico : 0,73
fuelEnergyDensityInMJoulesPerLiter	query		number double	Specifica la quantità di energia chimica memorizzata in un litri di carburante in megajoules (MJ). Viene usato insieme ai parametri *Efficiency per le conversioni tra energia salvata o consumata e combustibile. Ad esempio, la densità energetica è 34,2 MJ/l per la benzina e 35,8 MJ/l per il carburante Diesel. Questo parametro è obbligatorio se è impostato un parametro *Efficiency. Valori sensibili: 34.2
hilliness	query		InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.
instructionsType	query		RouteInstructionsType	Se specificato, verranno restituite istruzioni aggiuntive. Si noti che il parametro instructionsType non può essere usato insieme a routeRepresentation=none.
language	query		string	Il parametro language determina la lingua dei messaggi di guida. I sostantivi appropriati (i nomi delle strade, delle piazze e così via) vengono restituiti nella lingua specificata o, se ciò non è disponibile, vengono restituiti in una lingua disponibile vicina. I valori consentiti sono (un subset di) i tag di lingua IETF. Le lingue attualmente supportate sono elencate nella sezione lingue supportate . Valore predefinito: en-GB
maxAlternatives	query		integer	Numero di route alternative desiderate da calcolare. Impostazione predefinita: 0, minimo: 0 e massimo: 5
maxChargeInkWh	query		number double	Specifica la fornitura massima di energia elettrica in kilowatt ore (kWh) che possono essere memorizzate nella batteria del veicolo. Questo parametro coesiste con parametro currentChargeInkWh. Il valore minimo deve essere maggiore o uguale a currentChargeInkWh. Valori sensibili: 85
minDeviationDistance	query		integer	Tutte le route alternative restituite seguiranno la route di riferimento (vedere la sezione Richieste POST) dal punto di origine della richiesta calculateRoute per almeno questo numero di metri. Può essere utilizzato solo durante la ricostruzione di un percorso. Il parametro minDeviationDistance non può essere utilizzato in combinazione con arriveAt
minDeviationTime	query		integer	Tutte le route alternative restituite seguiranno la route di riferimento (vedere la sezione Richieste POST) dal punto di origine della richiesta calculateRoute per almeno questo numero di secondi. Può essere utilizzato solo durante la ricostruzione di un percorso. Il parametro minDeviationTime non può essere utilizzato insieme a arriveAt. Il valore predefinito è 0. L'impostazione di )minDeviationTime_ su un valore maggiore di zero ha le conseguenze seguenti: Il punto di origine del calculateRoute Request deve trovarsi nella route di riferimento di input (o molto vicino). In caso contrario, viene restituito un errore. Tuttavia, il punto di origine non deve essere all'inizio del percorso di riferimento di input (può essere considerato come la posizione corrente del veicolo sul percorso di riferimento). La route di riferimento, restituita come prima route nel calculateRoute Response, inizierà dal punto di origine specificato nel calculateRoute Request. Parte iniziale della route di riferimento di input fino a quando il punto di origine non verrà escluso dalla risposta. I valori di minDeviationDistance e minDeviationTime determinare la distanza di percorsi alternativi che saranno garantiti per seguire il percorso di riferimento dal punto di origine in poi. La route deve usare departAt. Il veicoloHeading viene ignorato.
report	query		Report	Specifica i dati da segnalare a scopo di diagnosi. L'unico valore possibile è effectiveSettings. Segnala i parametri o i dati effettivi usati durante la chiamata all'API. Nel caso dei parametri predefiniti, l'impostazione predefinita verrà riflessa in cui il parametro non è stato specificato dal chiamante.
routeRepresentation	query		RouteRepresentationForBestOrder	Specifica la rappresentazione del set di route fornite come risposta.
routeType	query		RouteType	Tipo di route richiesto.
sectionType	query		SectionType[]	Specifica quale dei tipi di sezione viene segnalato nella risposta di route. Ad esempio, se sectionType = le sezioni pedonali adatte ai pedoni vengono restituite solo. Può essere specificato più volte in una richiesta, ad esempio '§ionType=carTrain§ionType=pedestrian§ionType=autostrada'. La sezione predefinitaType fa riferimento all'input travelMode. Per impostazione predefinita travelMode è impostato su auto
traffic	query		boolean	Valori possibili: true - Prendere in considerazione tutte le informazioni sul traffico disponibili durante il routing false: ignorare i dati correnti del traffico durante il routing. Si noti che, sebbene i dati di traffico correnti vengano ignorati durante il routing, l'effetto del traffico storico sulle velocità effettive della strada è ancora incorporato.
travelMode	query		TravelMode	Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è 'car'. Si noti che l'oggetto travelMode richiesto potrebbe non essere disponibile per l'intera route. Se la proprietà travelMode richiesta non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "other". Si noti che le modalità di viaggio bus, moto, taxi e furgoni sono funzionalità BETA. I dati di restrizione completi non sono disponibili in tutte le aree.
uphillEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia chimica memorizzata nel combustibile in energia potenziale quando il veicolo ottiene l'elevazione (ad esempio, PotentialBytesGained/ChemicalBytesConsumed). Il Chemical VaultConsumed viene ottenuto convertendo il combustibile consumato in energia chimica utilizzando fuel VaultDensityInMJoulesPerLiter. Deve essere associato a discesaEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/discesaEfficienza. Valori sensibili: per modello di combustione : 0,27, per modello elettrico : 0,74
vehicleAxleWeight	query		integer	Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.
vehicleCommercial	query		boolean	Indica se il veicolo viene utilizzato per scopi commerciali. I veicoli commerciali potrebbero non essere autorizzati a guidare su alcune strade.
vehicleEngineType	query		VehicleEngineType	Tipo di motore del veicolo. Quando viene specificato un modello di consumo dettagliato, deve essere coerente con il valore di vehicleEngineType.
vehicleHeading	query		integer	La direzione direzionale del veicolo in gradi a partire dal vero Nord e continua in senso orario. Nord è di 0 gradi, est è di 90 gradi, sud è di 180 gradi, ovest è di 270 gradi. Valori possibili da 0 a 359
vehicleHeight	query		number double	Altezza del veicolo in metri. Il valore 0 indica che le restrizioni di altezza non vengono considerate.
vehicleLength	query		number double	Lunghezza del veicolo in metri. Il valore 0 indica che le restrizioni di lunghezza non vengono considerate.
vehicleLoadType	query		VehicleLoadType	Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi/aree geografiche. I valori che iniziano con USHazmat sono per il routing degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi/aree geografiche. vehicleLoadType può essere specificato più volte. Questo parametro è attualmente considerato solo per travelMode=truck.
vehicleMaxSpeed	query		integer	Velocità massima del veicolo in km/ora. La velocità massima nel profilo del veicolo viene utilizzata per verificare se un veicolo è consentito sulle autostrade. Il valore 0 indica che un valore appropriato per il veicolo verrà determinato e applicato durante la pianificazione del percorso. È possibile eseguire l'override di un valore diverso da zero durante la pianificazione della route. Ad esempio, il flusso di traffico corrente è di 60 km/ora. Se la velocità massima del veicolo è impostata su 50 km/ora, il motore di instradamento considererà 60 km/ora in quanto si tratta della situazione attuale. Se la velocità massima del veicolo viene fornita come 80 km/ora, ma il flusso di traffico corrente è di 60 km/ora, il motore di instradamento utilizzerà di nuovo 60 km/ora.
vehicleWeight	query		integer	Peso del veicolo in kg. È obbligatorio se sono impostati uno dei parametri *Efficiency. Deve essere strettamente positivo se usato nel contesto del modello a consumo. Vengono prese in considerazione le restrizioni relative al peso. Se non viene specificato alcun modello di consumo dettagliato e il valore di vehicleWeight è diverso da zero, vengono considerate le restrizioni relative al peso. In tutti gli altri casi, questo parametro viene ignorato. Valori sensibili: per modello di combustione : 1600, per modello elettrico : 1900
vehicleWidth	query		number double	Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.
windingness	query		WindingnessLevel	Livello di turni per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-id		string	Specifica quale account è destinato all'utilizzo in combinazione con il modello di sicurezza Microsoft Entra ID. Rappresenta un ID univoco per l'account mappe di Azure e può essere recuperato dall'API dell'account del piano di gestione di Mappe di Azure. Per usare la sicurezza di Microsoft Entra ID in Mappe di Azure, vedere gli articoli di seguenti per indicazioni.

Risposte

Nome	Tipo	Descrizione
200 OK	RouteDirections	OK
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto.

Sicurezza

AADToken

Questi sono i flussi di Microsoft Entra OAuth 2.0. Se abbinato a l'accesso in base al ruolo di Azure controllarlo, può essere usato per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso in base al ruolo di Azure vengono usati per designare l'accesso a uno o più account di risorse di Mappe di Azure o a risorse secondarie. A qualsiasi utente, gruppo o entità servizio può essere concesso l'accesso tramite un ruolo predefinito o un ruolo personalizzato composto da una o più autorizzazioni per le API REST di Mappe di Azure.

Per implementare scenari, è consigliabile visualizzare concetti di autenticazione. In sintesi, questa definizione di sicurezza offre una soluzione per la modellazione di applicazioni tramite oggetti in grado di controllare l'accesso su API e ambiti specifici.

Note

• Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale risorsa di Mappe di Azure l'applicazione richiede l'accesso. Questa operazione può essere acquisita dall'API di gestione di mappe .

Il Authorization URL è specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni microsoft Entra ID. * Il controllo degli accessi in base al ruolo di Azure viene configurato dal piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST. * L'utilizzo del Sdk Web di Mappe di Azure consente la configurazione basata sulla configurazione di un'applicazione per più casi d'uso.

• Per altre informazioni su Microsoft Identity Platform, vedere panoramica di Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Si tratta di una chiave condivisa di cui viene effettuato il provisioning quando si Creare un account di Mappe di Azure nel portale di Azure o usando PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o l'API REST.

Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere usata come chiave master nell'account in cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'approccio applicazioni client riservate per accedere alle API REST di Mappe di Azure in modo che la chiave possa essere archiviata in modo sicuro.

Tipo: apiKey
In: query

SAS Token

Si tratta di un token di firma di accesso condiviso creato dall'operazione List SAS nell'risorsa di Mappe di Azure tramite il piano di gestione di Azure tramite il portale di Azure, PowerShell, l'interfaccia della riga di comando, gli SDK di Azure o le API REST.

Con questo token, qualsiasi applicazione è autorizzata ad accedere ai controlli di accesso in base al ruolo di Azure e al controllo granulare per la scadenza, la frequenza e le aree d'uso per il token specifico. In altre parole, il token di firma di accesso condiviso può essere usato per consentire alle applicazioni di controllare l'accesso in modo più protetto rispetto alla chiave condivisa.

Per le applicazioni esposte pubblicamente, è consigliabile configurare un elenco specifico di origini consentite nella risorsa account mappa per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Successfully retrieve a route between an origin and a destination

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings

Risposta di esempio

Codice di stato:

200

{
  "formatVersion": "0.0.12",
  "routes": [
    {
      "summary": {
        "lengthInMeters": 1147,
        "travelTimeInSeconds": 162,
        "trafficDelayInSeconds": 0,
        "departureTime": "2017-09-07T16:56:58+00:00",
        "arrivalTime": "2017-09-07T16:59:40+00:00"
      },
      "legs": [
        {
          "summary": {
            "lengthInMeters": 1147,
            "travelTimeInSeconds": 162,
            "trafficDelayInSeconds": 0,
            "departureTime": "2017-09-07T16:56:58+00:00",
            "arrivalTime": "2017-09-07T16:59:40+00:00"
          },
          "points": [
            {
              "latitude": 52.50931,
              "longitude": 13.42937
            },
            {
              "latitude": 52.50904,
              "longitude": 13.42912
            },
            {
              "latitude": 52.50894,
              "longitude": 13.42904
            },
            {
              "latitude": 52.50867,
              "longitude": 13.42879
            },
            {
              "latitude": 52.5084,
              "longitude": 13.42857
            },
            {
              "latitude": 52.50791,
              "longitude": 13.42824
            },
            {
              "latitude": 52.50757,
              "longitude": 13.42772
            },
            {
              "latitude": 52.50735,
              "longitude": 13.42823
            },
            {
              "latitude": 52.5073,
              "longitude": 13.42836
            },
            {
              "latitude": 52.50573,
              "longitude": 13.43194
            },
            {
              "latitude": 52.50512,
              "longitude": 13.43336
            },
            {
              "latitude": 52.50464,
              "longitude": 13.43451
            },
            {
              "latitude": 52.5045,
              "longitude": 13.43481
            },
            {
              "latitude": 52.50443,
              "longitude": 13.43498
            },
            {
              "latitude": 52.50343,
              "longitude": 13.43737
            },
            {
              "latitude": 52.50274,
              "longitude": 13.43872
            }
          ]
        }
      ],
      "sections": [
        {
          "startPointIndex": 0,
          "endPointIndex": 15,
          "sectionType": "TRAVEL_MODE",
          "travelMode": "car"
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
AlternativeRouteType	Controlla l'ottimalità, in relazione ai criteri di pianificazione specificati, delle alternative calcolate rispetto alla route di riferimento.
ComputeTravelTime	Specifica se restituire tempi di viaggio aggiuntivi usando tipi diversi di informazioni sul traffico (none, cronologia, dinamica) e il tempo di viaggio migliore predefinito.
DelayMagnitude	La grandezza del ritardo causato dall'incidente. Questi valori corrispondono ai valori del campo di risposta ty dell'API Get Traffic Incident Detail.
DrivingSide	Indica la guida a sinistra o a destra al punto della manovra.
EffectiveSetting	Parametro o dati effettivi usati quando si chiama questa API di route.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GuidanceInstructionType	Tipo di istruzione, ad esempio turno o modifica della forma stradale.
GuidanceManeuver	Codice che identifica la manovra.
InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.
JunctionType	Tipo di giunzione in cui si svolge la manovra. Per le rotatorie più grandi, vengono generate due istruzioni separate per entrare e lasciare la rotatoria.
LatLongPair	Posizione rappresentata come latitudine e longitudine.
Report	Specifica i dati da segnalare a scopo di diagnosi. L'unico valore possibile è effectiveSettings. Segnala i parametri o i dati effettivi usati durante la chiamata all'API. Nel caso dei parametri predefiniti, l'impostazione predefinita verrà riflessa in cui il parametro non è stato specificato dal chiamante.
ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
ResponseSectionType	Tipi di sezione della risposta di route segnalata
ResponseTravelMode	Modalità di viaggio per il percorso calcolato. Il valore verrà impostato su other se la modalità richiesta di trasporto non è possibile in questa sezione
Route
RouteAvoidType	Specifica un elemento che il calcolo della route deve tentare di evitare quando si determina la route. Può essere specificato più volte in una richiesta, ad esempio "&evitare=autostrade&evitare=tollRoads&evitare=traghetti". Nelle richieste di intervallo di route il valore giàUsedRoads non deve essere usato.
RouteDirections	Questo oggetto viene restituito da una chiamata route directions riuscita
RouteGuidance	Contiene elementi correlati alle linee guida. Questo campo è presente solo quando sono state richieste indicazioni ed è disponibile.
RouteInstruction	Un set di attributi che descrivono una manovra, ad esempio "Gira a destra", "Mantieni a sinistra", "Prendi il traghetto", "Prendi l'autostrada", "Arriva".
RouteInstructionGroup	Raggruppa una sequenza di elementi di istruzione correlati tra loro. L'intervallo di sequenze è vincolato con firstInstructionIndex e lastInstructionIndex. Quando vengono richiesti messaggi di testo leggibili per indicazioni (instructionType=text o tagged), il gruppo di istruzioni ha un messaggio di riepilogo restituito quando disponibile.
RouteInstructionsType	Se specificato, verranno restituite istruzioni aggiuntive. Si noti che il parametro instructionsType non può essere usato insieme a routeRepresentation=none.
RouteLeg	Descrizione di una parte di un itinerario, costituito da un elenco di punti. Ogni punto di percorso aggiuntivo fornito nella richiesta comporterà una gamba aggiuntiva nel percorso restituito.
RouteLegSummary	Oggetto riepilogo per la sezione route.
RouteOptimizedWaypoint	Oggetto punto di ottimizzazione.
RouteReport	Segnala le impostazioni effettive usate nella chiamata corrente.
RouteRepresentationForBestOrder	Specifica la rappresentazione del set di route fornite come risposta.
RouteSection	Le sezioni route contengono informazioni aggiuntive sulle parti di un itinerario. Ogni sezione contiene almeno gli elementi startPointIndex, endPointIndexe sectionType.
RouteSectionTec	Dettagli dell'evento di traffico, usando le definizioni nello standard TPEG2-TPEG2. Può contenere effectCode e genera elementi.
RouteSectionTecCause	Causa dell'evento di traffico. Può contenere elementi mainCauseCode e subCauseCode. Può essere usato per definire iconografia e descrizioni.
RouteSummary	Oggetto Riepilogo
RouteType	Tipo di route richiesto.
SectionType	Specifica quale dei tipi di sezione viene segnalato nella risposta di route. Ad esempio, se sectionType = le sezioni pedonali adatte ai pedoni vengono restituite solo. Può essere specificato più volte in una richiesta, ad esempio '§ionType=carTrain§ionType=pedestrian§ionType=autostrada'. La sezione predefinitaType fa riferimento all'input travelMode. Per impostazione predefinita travelMode è impostato su auto
SimpleCategory	Tipo di evento imprevisto. Attualmente può essere JAM, ROAD_WORK, ROAD_CLOSURE o OTHER. Per informazioni dettagliate, vedere "tec".
TravelMode	Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è 'car'. Si noti che l'oggetto travelMode richiesto potrebbe non essere disponibile per l'intera route. Se la proprietà travelMode richiesta non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "other". Si noti che le modalità di viaggio bus, moto, taxi e furgoni sono funzionalità BETA. I dati di restrizione completi non sono disponibili in tutte le aree.
VehicleEngineType	Tipo di motore del veicolo. Quando viene specificato un modello di consumo dettagliato, deve essere coerente con il valore di vehicleEngineType.
VehicleLoadType	Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi/aree geografiche. I valori che iniziano con USHazmat sono per il routing degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi/aree geografiche. vehicleLoadType può essere specificato più volte. Questo parametro è attualmente considerato solo per travelMode=truck.
WindingnessLevel	Livello di turni per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.

AlternativeRouteType

Controlla l'ottimalità, in relazione ai criteri di pianificazione specificati, delle alternative calcolate rispetto alla route di riferimento.

Nome	Tipo	Descrizione
anyRoute	string	Consentire la restituzione di qualsiasi route alternativa indipendentemente dalla modalità di confronto con la route di riferimento in termini di ottimalità.
betterRoute	string	Restituisce un percorso alternativo solo se è meglio della route di riferimento in base ai criteri di pianificazione specificati.

ComputeTravelTime

Specifica se restituire tempi di viaggio aggiuntivi usando tipi diversi di informazioni sul traffico (none, cronologia, dinamica) e il tempo di viaggio migliore predefinito.

Nome	Tipo	Descrizione
all	string	Calcola i tempi di viaggio per tutti i tipi di informazioni sul traffico e specifica tutti i risultati nei campi noTrafficTypeTimeInSeconds, historicTrafficClientTimeInSeconds e liveTrafficIncidentsTypeTimeInSeconds inclusi nei riepiloghi nella risposta di route.
none	string	Non calcola tempi di viaggio aggiuntivi.

DelayMagnitude

La grandezza del ritardo causato dall'incidente. Questi valori corrispondono ai valori del campo di risposta ty dell'API Get Traffic Incident Detail.

Nome	Tipo	Descrizione
0	string	Sconosciuto.
1	string	Minore.
2	string	Moderato.
3	string	Maggiore.
4	string	Indefinito, utilizzato per le chiuse stradali e altri ritardi indefiniti.

DrivingSide

Indica la guida a sinistra o a destra al punto della manovra.

Nome	Tipo	Descrizione
LEFT	string	A sinistra.
RIGHT	string	Destra.

EffectiveSetting

Parametro o dati effettivi usati quando si chiama questa API di route.

Nome	Tipo	Descrizione
key	string	Nome del parametro utilizzato.
value	string	Valore del parametro utilizzato.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GuidanceInstructionType

Tipo di istruzione, ad esempio turno o modifica della forma stradale.

Nome	Tipo	Descrizione
DIRECTION_INFO	string	Informazioni sulla direzione.
LOCATION_ARRIVAL	string	Posizione di arrivo.
LOCATION_DEPARTURE	string	Posizione di partenza.
LOCATION_WAYPOINT	string	Posizione del punto di direzione.
ROAD_CHANGE	string	Cambiamento di strada.
TURN	string	Girare.

GuidanceManeuver

Codice che identifica la manovra.

Nome	Tipo	Descrizione
ARRIVE	string	Sei arrivato.
ARRIVE_LEFT	string	Sei arrivato. La destinazione è a sinistra.
ARRIVE_RIGHT	string	Sei arrivato. La destinazione è a destra.
BEAR_LEFT	string	Orso a sinistra.
BEAR_RIGHT	string	Bear right.
DEPART	string	Partire.
ENTER_FREEWAY	string	Prendi la strada libera.
ENTER_HIGHWAY	string	Prendi l'autostrada.
ENTER_MOTORWAY	string	Prendi l'autostrada.
ENTRANCE_RAMP	string	Prendi la rampa.
FOLLOW	string	Seguire.
KEEP_LEFT	string	Mantieni a sinistra.
KEEP_RIGHT	string	Continuate bene.
MAKE_UTURN	string	Fai un turno U.
MOTORWAY_EXIT_LEFT	string	Prendi l'uscita sinistra.
MOTORWAY_EXIT_RIGHT	string	Esci a destra.
ROUNDABOUT_BACK	string	Andate in giro per la rotatoria.
ROUNDABOUT_CROSS	string	Attraversare la rotatoria.
ROUNDABOUT_LEFT	string	Alla rotatoria prendere l'uscita a sinistra.
ROUNDABOUT_RIGHT	string	Alla rotatoria prendere l'uscita a destra.
SHARP_LEFT	string	Girare a sinistra tagliente.
SHARP_RIGHT	string	Girate a destra.
STRAIGHT	string	Continuate dritto.
SWITCH_MAIN_ROAD	string	Passare alla strada principale.
SWITCH_PARALLEL_ROAD	string	Passare alla strada parallela.
TAKE_EXIT	string	Prendi l'uscita.
TAKE_FERRY	string	Prendi il traghetto.
TRY_MAKE_UTURN	string	Prova a fare un turno U.
TURN_LEFT	string	Gira a sinistra.
TURN_RIGHT	string	Gira a destra.
WAYPOINT_LEFT	string	Hai raggiunto il punto di arrivo. È a sinistra.
WAYPOINT_REACHED	string	Hai raggiunto il punto di arrivo.
WAYPOINT_RIGHT	string	Hai raggiunto il punto di arrivo. È a destra.

InclineLevel

Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.

Nome	Tipo	Descrizione
high	string	alto
low	string	basso
normal	string	normale

JunctionType

Tipo di giunzione in cui si svolge la manovra. Per le rotatorie più grandi, vengono generate due istruzioni separate per entrare e lasciare la rotatoria.

Nome	Tipo	Descrizione
BIFURCATION	string	biforcazione
REGULAR	string	regolare
ROUNDABOUT	string	rotonda

LatLongPair

Posizione rappresentata come latitudine e longitudine.

Nome	Tipo	Descrizione
latitude	number	Proprietà Latitude
longitude	number	Longitudine - proprietà

Report

Specifica i dati da segnalare a scopo di diagnosi. L'unico valore possibile è effectiveSettings. Segnala i parametri o i dati effettivi usati durante la chiamata all'API. Nel caso dei parametri predefiniti, l'impostazione predefinita verrà riflessa in cui il parametro non è stato specificato dal chiamante.

Nome	Tipo	Descrizione
effectiveSettings	string	Segnala i parametri o i dati effettivi usati durante la chiamata all'API.

ResponseFormat

Formato desiderato della risposta. Il valore può essere json o xml.

Nome	Tipo	Descrizione
json	string	il formato dell'interscambio dati notazione oggetto JavaScript
xml	string	la extensible markup language

ResponseSectionType

Tipi di sezione della risposta di route segnalata

Nome	Tipo	Descrizione
CARPOOL	string	Sezioni del percorso che richiedono l'uso di carpooling (HOV/High Occupancy Vehicle) corsie.
CAR_TRAIN	string	Sezioni del percorso che sono auto o treni.
COUNTRY	string	Sezioni che indicano i paesi o le aree geografiche in cui si trova il percorso.
FERRY	string	Sezioni del percorso che sono traghetti.
MOTORWAY	string	Sezioni del percorso che sono autostrade.
PEDESTRIAN	string	Sezioni del percorso che sono adatte solo per i pedoni.
TOLL_ROAD	string	Sezioni del percorso che richiedono un pedaggio da pagare.
TOLL_VIGNETTE	string	Sezioni del percorso che richiedono che sia presente una vignetta a pedaggio.
TRAFFIC	string	Sezioni della route che contengono informazioni sul traffico.
TRAVEL_MODE	string	Sezioni relative al parametro della richiesta travelMode.
TUNNEL	string	Sezioni del percorso che sono tunnel.
URBAN	string	Sezioni del percorso che si trovano all'interno delle aree urbane.

ResponseTravelMode

Modalità di viaggio per il percorso calcolato. Il valore verrà impostato su other se la modalità richiesta di trasporto non è possibile in questa sezione

Nome	Tipo	Descrizione
bicycle	string	I percorsi restituiti sono ottimizzati per le biciclette, incluso l'uso di corsie per biciclette.
bus	string	I percorsi restituiti sono ottimizzati per gli autobus, incluso l'uso di solo corsie di autobus. Funzionalità BETA.
car	string	I percorsi restituiti sono ottimizzati per le auto.
motorcycle	string	I percorsi restituiti sono ottimizzati per le moto. Funzionalità BETA.
other	string	La modalità di trasporto specificata non è possibile in questa sezione
pedestrian	string	I percorsi restituiti sono ottimizzati per i pedoni, incluso l'uso di marciapiedi.
taxi	string	I percorsi restituiti sono ottimizzati per i taxi. Funzionalità BETA.
truck	string	I percorsi restituiti sono ottimizzati per i veicoli commerciali, come per i camion.
van	string	I percorsi restituiti sono ottimizzati per i furgoni. Funzionalità BETA.

Route

Nome	Tipo	Descrizione
guidance	RouteGuidance	Contiene elementi correlati alle linee guida. Questo campo è presente solo quando sono state richieste indicazioni ed è disponibile.
legs	RouteLeg[]	Matrice gambe
sections	RouteSection[]	Matrice di sezioni
summary	RouteSummary	Oggetto Riepilogo

RouteAvoidType

Specifica un elemento che il calcolo della route deve tentare di evitare quando si determina la route. Può essere specificato più volte in una richiesta, ad esempio "&evitare=autostrade&evitare=tollRoads&evitare=traghetti". Nelle richieste di intervallo di route il valore giàUsedRoads non deve essere usato.

Nome	Tipo	Descrizione
alreadyUsedRoads	string	Evita di usare la stessa strada più volte. Più utile in combinazione con routeType=emozionante.
borderCrossings	string	Evita di attraversare i confini nel calcolo del percorso.
carpools	string	Evita percorsi che richiedono l'uso di corsie di carpooling (HOV/High Occupancy Vehicle).
ferries	string	Evita i traghetti
motorways	string	Evita le autostrade
tollRoads	string	Evita strade a pedaggio.
unpavedRoads	string	Evita strade non pavimentate

RouteDirections

Questo oggetto viene restituito da una chiamata route directions riuscita

Nome	Tipo	Descrizione
formatVersion	string	Format Version - proprietà
optimizedWaypoints	RouteOptimizedWaypoint[]	Sequenza ottimizzata di punti di direzione. Mostra l'indice della sequenza waypoint fornita dall'utente per l'elenco originale e ottimizzato. Ad esempio, una risposta: <optimizedWaypoints> <waypoint providedIndex="0" optimizedIndex="1"/> <waypoint providedIndex="1" optimizedIndex="2"/> <waypoint providedIndex="2" optimizedIndex="0"/> </optimizedWaypoints> significa che la sequenza originale è [0, 1, 2] e la sequenza ottimizzata è [1, 2, 0]. Poiché l'indice inizia da 0, l'originale è "primo, secondo, terzo" mentre l'oggetto ottimizzato è "secondo, terzo, primo".
report	RouteReport	Segnala le impostazioni effettive usate nella chiamata corrente.
routes	Route[]	Matrice di route

RouteGuidance

Contiene elementi correlati alle linee guida. Questo campo è presente solo quando sono state richieste indicazioni ed è disponibile.

Nome	Tipo	Descrizione
instructionGroups	RouteInstructionGroup[]	Raggruppa una sequenza di elementi di istruzione correlati tra loro.
instructions	RouteInstruction[]	Un elenco di istruzioni che descrivono le manovre.

RouteInstruction

Un set di attributi che descrivono una manovra, ad esempio "Gira a destra", "Mantieni a sinistra", "Prendi il traghetto", "Prendi l'autostrada", "Arriva".

Nome	Tipo	Descrizione
combinedMessage	string	Messaggio leggibile per la manovra combinata con il messaggio dell'istruzione successiva. A volte è possibile combinare due istruzioni successive in un'unica istruzione rendendo più semplice seguire. In questo caso, il flag possibleCombineWithNext sarà true. Per esempio: 10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam 11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam Il flag possibleCombineWithNext sull'istruzione 10 è true. Ciò indica ai client di indicazioni codificate che possono essere combinate con l'istruzione 11. Le istruzioni verranno combinate automaticamente per i client che richiedono indicazioni leggibili. Il campo combinedMessage contiene il messaggio combinato: Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam then follow Einsteinweg/A10/E22 towards Ring Amsterdam.
countryCode	string	3 caratteri ISO 3166-1 codice paese alfa-3. Ad esempio, USA.
drivingSide	DrivingSide	Indica la guida a sinistra o a destra al punto della manovra.
exitNumber	string	Il numero di un'uscita autostrada presa dalla manovra corrente. Se un'uscita ha più numeri di uscita, verranno separati da "," ed eventualmente aggregati da "-", ad esempio "10, 13-15".
instructionType	GuidanceInstructionType	Tipo di istruzione, ad esempio turno o modifica della forma stradale.
junctionType	JunctionType	Tipo di giunzione in cui si svolge la manovra. Per le rotatorie più grandi, vengono generate due istruzioni separate per entrare e lasciare la rotatoria.
maneuver	GuidanceManeuver	Codice che identifica la manovra.
message	string	Un messaggio leggibile per la manovra.
point	LatLongPair	Posizione rappresentata come latitudine e longitudine.
pointIndex	integer	Indice del punto nell'elenco di "punti" polilinea corrispondente al punto dell'istruzione.
possibleCombineWithNext	boolean	Facoltativamente, è possibile combinare l'istruzione con quella successiva. Può essere usato per compilare messaggi come "Turn left and then turn right".
roadNumbers	string[]	I numeri stradali del prossimo segmento di strada significativo dopo la manovra o delle strade da seguire. Esempio: ["E34", "N205"]
roundaboutExitNumber	integer	Indica l'uscita da prendere in una rotatoria.
routeOffsetInMeters	integer	Distanza dall'inizio della route al punto dell'istruzione.
signpostText	string	Il testo su un segnaposto che è più rilevante per la manovra, o per la direzione che deve essere seguita.
stateCode	string	Una suddivisione (ad esempio, stato) del paese, rappresentata dalla seconda parte di un codice ISO 3166-2. Questa opzione è disponibile solo per alcuni paesi/aree geografiche, ad esempio Stati Uniti, Canada e Messico.
street	string	Nome della strada del prossimo segmento di strada significativo dopo la manovra, o della strada che dovrebbe essere seguita.
travelTimeInSeconds	integer	Tempo di viaggio stimato fino al punto corrispondente a routeOffsetInMeters.
turnAngleInDecimalDegrees	integer	Indica la direzione di un'istruzione. Se junctionType indica un'istruzione turn: 180 = U-turn [-179, -1] = Turno sinistro 0 = Dritto (un turno di 0 gradi) [1, 179] = Turno destro Se junctionType indica un'istruzione di biforcazione: <0 - Mantenere a sinistra >0 - Tenere a destra

RouteInstructionGroup

Raggruppa una sequenza di elementi di istruzione correlati tra loro. L'intervallo di sequenze è vincolato con firstInstructionIndex e lastInstructionIndex. Quando vengono richiesti messaggi di testo leggibili per indicazioni (instructionType=text o tagged), il gruppo di istruzioni ha un messaggio di riepilogo restituito quando disponibile.

Nome	Tipo	Descrizione
firstInstructionIndex	integer	Indice della prima istruzione nelle istruzioni e appartenenza a questo gruppo.
groupLengthInMeters	integer	Lunghezza del gruppo.
groupMessage	string	Messaggio di riepilogo quando vengono richiesti messaggi di testo leggibili per istruzioni (instructionType=text o con tag).
lastInstructionIndex	integer	Indice dell'ultima istruzione nelle istruzioni e appartenenza a questo gruppo.

RouteInstructionsType

Se specificato, verranno restituite istruzioni aggiuntive. Si noti che il parametro instructionsType non può essere usato insieme a routeRepresentation=none.

Nome	Tipo	Descrizione
coded	string	Restituisce dati di istruzioni non elaborati senza messaggi leggibili dall'utente.
tagged	string	Restituisce dati di istruzioni non elaborate con messaggi leggibili con tag per consentire la formattazione. Un messaggio leggibile viene creato da elementi identificati ripetibili. Questi tag sono contrassegnati per consentire alle applicazioni client di formattarle correttamente. I componenti del messaggio seguenti vengono contrassegnati quando instructionsType=tagged: street, roadNumber, signpostText, exitNumber, roadmapExitNumber. Esempio di messaggio con tag 'Turn left': Turn left onto <roadNumber>A4</roadNumber>/<roadNumber>E19</roadNumber> towards <signpostText>Den Haag</signpostText>
text	string	Restituisce dati di istruzioni non elaborate con messaggi leggibili in testo normale.

RouteLeg

Descrizione di una parte di un itinerario, costituito da un elenco di punti. Ogni punto di percorso aggiuntivo fornito nella richiesta comporterà una gamba aggiuntiva nel percorso restituito.

Nome	Tipo	Descrizione
points	LatLongPair[]	Matrice di punti
summary	RouteLegSummary	Oggetto riepilogo per la sezione route.

RouteLegSummary

Oggetto riepilogo per la sezione route.

Nome	Tipo	Descrizione
arrivalTime	string	Ora di arrivo stimata per il percorso o la gamba. L'ora è in formato UTC.
batteryConsumptionInkWh	number	Consumo di energia elettrica stimato in kilowatt ore (kWh) usando il modello a consumo elettrico. Incluso se vehicleEngineType è impostato su electric e constantSpeedConsumptionInkWhPerHundredkm è specificato. Il valore della batteriaConsumptionInkWh include l'energia elettrica recuperata e può quindi essere negativo (che indica l'acquisizione di energia). Se vengono specificati sia maxChargeInkWh che currentChargeInkWh, il recupero verrà limitato per garantire che il livello di carica della batteria non superi mai maxChargeInkWh. Se non si specificano né maxChargeInkWh né currentChargeInkWh, nel calcolo del consumo viene utilizzato il recupero non vincolato.
departureTime	string	Ora di partenza stimata per il percorso o la gamba. L'ora è in formato UTC.
fuelConsumptionInLiters	number	Consumo stimato di carburante in litri utilizzando il modello a consumo di combustione. Incluso se vehicleEngineType è impostato su di combustione e viene specificato constantSpeedConsumptionInLitersPerHundredkm. Il valore sarà non negativo.
historicTrafficTravelTimeInSeconds	integer	Tempo di viaggio stimato calcolato usando dati di traffico cronologici dipendenti dal tempo. Incluso solo se computeDestinazioniTimeFor = tutto viene usato nella query.
lengthInMeters	integer	Proprietà Length In Meters
liveTrafficIncidentsTravelTimeInSeconds	integer	Tempo di viaggio stimato calcolato usando i dati sulla velocità in tempo reale. Incluso solo se computeDestinazioniTimeFor = tutto viene usato nella query.
noTrafficTravelTimeInSeconds	integer	Tempo di viaggio stimato calcolato come se non ci siano ritardi sulla rotta a causa di condizioni del traffico (ad esempio, congestione). Incluso solo se computeDestinazioniTimeFor = tutto viene usato nella query.
trafficDelayInSeconds	integer	Ritardo stimato in secondi causato dagli eventi imprevisti in tempo reale in base alle informazioni sul traffico. Per gli itinerari pianificati con l'orario di partenza in futuro, i ritardi sono sempre 0. Per restituire tempi di viaggio aggiuntivi usando diversi tipi di informazioni sul traffico, è necessario aggiungere il parametro computeTimeFor=all.
travelTimeInSeconds	integer	Tempo di viaggio stimato in secondi proprietà che include il ritardo dovuto al traffico in tempo reale. Si noti che anche quando traffic=false travelTimeInSeconds include ancora il ritardo dovuto al traffico. Se DepartAt è in futuro, il tempo di viaggio viene calcolato usando dati cronologici cronologici dipendenti dal tempo.

RouteOptimizedWaypoint

Oggetto punto di ottimizzazione.

Nome	Tipo	Descrizione
optimizedIndex	integer	Indice del punto di modo ottimizzato dal sistema.
providedIndex	integer	Indice del punto di modo fornito dall'utente.

RouteReport

Segnala le impostazioni effettive usate nella chiamata corrente.

Nome	Tipo	Descrizione
effectiveSettings	EffectiveSetting[]	Parametri o dati effettivi usati quando si chiama questa API di route.

RouteRepresentationForBestOrder

Specifica la rappresentazione del set di route fornite come risposta.

Nome	Tipo	Descrizione
none	string	Include solo gli indici waypoint ottimizzati, ma non include la geometria di route nella risposta. Questo valore di parametro può essere usato solo insieme a computeBestOrder=true.
polyline	string	Include la geometria di route nella risposta.
summaryOnly	string	Riepilogo in base alla polilinea, ma escluso gli elementi geometry del punto per le route nella risposta.

RouteSection

Le sezioni route contengono informazioni aggiuntive sulle parti di un itinerario. Ogni sezione contiene almeno gli elementi startPointIndex, endPointIndexe sectionType.

Nome	Tipo	Descrizione
delayInSeconds	integer	Ritardo in secondi causato dall'evento imprevisto.
effectiveSpeedInKmh	integer	Velocità effettiva dell'incidente in km/h, mediata per tutta la sua lunghezza.
endPointIndex	integer	Indice dell'ultimo punto (offset 0) nella route a cui si applica questa sezione.
magnitudeOfDelay	DelayMagnitude	La grandezza del ritardo causato dall'incidente. Questi valori corrispondono ai valori del campo di risposta ty dell'API Get Traffic Incident Detail.
sectionType	ResponseSectionType	Tipi di sezione della risposta di route segnalata
simpleCategory	SimpleCategory	Tipo di evento imprevisto. Attualmente può essere JAM, ROAD_WORK, ROAD_CLOSURE o OTHER. Per informazioni dettagliate, vedere "tec".
startPointIndex	integer	Indice del primo punto (offset 0) nella route a cui si applica questa sezione.
tec	RouteSectionTec	Dettagli dell'evento di traffico, usando le definizioni nello standard TPEG2-TPEG2. Può contenere effectCode e genera elementi.
travelMode	ResponseTravelMode	Modalità di viaggio per il percorso calcolato. Il valore verrà impostato su other se la modalità richiesta di trasporto non è possibile in questa sezione

RouteSectionTec

Dettagli dell'evento di traffico, usando le definizioni nello standard TPEG2-TPEG2. Può contenere effectCode e genera elementi.

Nome	Tipo	Descrizione
causes	RouteSectionTecCause[]	Causa la matrice
effectCode	integer	Effetto sul flusso di traffico. Contiene un valore nella tabella tec001:EffectCode, come definito nello standard TPEG2-TEC. Può essere usato per codificare gli eventi di traffico a colori in base alla gravità.

RouteSectionTecCause

Causa dell'evento di traffico. Può contenere elementi mainCauseCode e subCauseCode. Può essere usato per definire iconografia e descrizioni.

Nome	Tipo	Descrizione
mainCauseCode	integer	Causa principale dell'evento di traffico. Contiene un valore nella tabella tec002:CauseCode, come definito nello standard TPEG2 TPEG2.
subCauseCode	integer	Sottocausa dell'evento di traffico. Contiene un valore nella tabella delle cause secondarie definita dal mainCauseCode, come definito nello standard TPEG2-TEC .

RouteSummary

Oggetto Riepilogo

Nome	Tipo	Descrizione
arrivalTime	string	Ora di arrivo stimata per il percorso o la gamba. L'ora è in formato UTC.
departureTime	string	Ora di partenza stimata per il percorso o la gamba. L'ora è in formato UTC.
lengthInMeters	integer	Proprietà Length In Meters
trafficDelayInSeconds	integer	Ritardo stimato in secondi causato dagli eventi imprevisti in tempo reale in base alle informazioni sul traffico. Per gli itinerari pianificati con l'orario di partenza in futuro, i ritardi sono sempre 0. Per restituire tempi di viaggio aggiuntivi usando diversi tipi di informazioni sul traffico, è necessario aggiungere il parametro computeTimeFor=all.
travelTimeInSeconds	integer	Tempo di viaggio stimato in secondi proprietà che include il ritardo dovuto al traffico in tempo reale. Si noti che anche quando traffic=false travelTimeInSeconds include ancora il ritardo dovuto al traffico. Se DepartAt è in futuro, il tempo di viaggio viene calcolato usando dati cronologici cronologici dipendenti dal tempo.

RouteType

Tipo di route richiesto.

Nome	Tipo	Descrizione
eco	string	Un percorso bilanciato dall'economia e dalla velocità.
fastest	string	Percorso più veloce.
shortest	string	Percorso più breve per distanza.
thrilling	string	Include strade interessanti o impegnative e utilizza il minor numero possibile di autostrade. È possibile scegliere il livello di turni inclusi e anche il grado di collina. Per informazioni su come impostare questa impostazione, vedere i parametri di collina e avvolgimento. C'è un limite di 900 km su itinerari pianificati con routeType=brivido

SectionType

Specifica quale dei tipi di sezione viene segnalato nella risposta di route.

Ad esempio, se sectionType = le sezioni pedonali adatte ai pedoni vengono restituite solo. Può essere specificato più volte in una richiesta, ad esempio '§ionType=carTrain§ionType=pedestrian§ionType=autostrada'. La sezione predefinitaType fa riferimento all'input travelMode. Per impostazione predefinita travelMode è impostato su auto

Nome	Tipo	Descrizione
carTrain	string	Sezioni del percorso che sono auto o treni.
carpool	string	Sezioni del percorso che richiedono l'uso di carpooling (HOV/High Occupancy Vehicle) corsie.
country	string	Sezioni che indicano i paesi o le aree geografiche in cui si trova il percorso.
ferry	string	Sezioni del percorso che sono traghetti.
motorway	string	Sezioni del percorso che sono autostrade.
pedestrian	string	Sezioni del percorso che sono adatte solo per i pedoni.
tollRoad	string	Sezioni del percorso che richiedono un pedaggio da pagare.
tollVignette	string	Sezioni del percorso che richiedono che sia presente una vignetta a pedaggio.
traffic	string	Sezioni della route che contengono informazioni sul traffico.
travelMode	string	Sezioni relative al parametro della richiesta travelMode.
tunnel	string	Sezioni del percorso che sono tunnel.
urban	string	Sezioni del percorso che si trovano all'interno delle aree urbane.

SimpleCategory

Tipo di evento imprevisto. Attualmente può essere JAM, ROAD_WORK, ROAD_CLOSURE o OTHER. Per informazioni dettagliate, vedere "tec".

Nome	Tipo	Descrizione
JAM	string	Ingorgo.
OTHER	string	Altro.
ROAD_CLOSURE	string	Chiusura stradale.
ROAD_WORK	string	Lavoro stradale.

TravelMode

Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è 'car'. Si noti che l'oggetto travelMode richiesto potrebbe non essere disponibile per l'intera route. Se la proprietà travelMode richiesta non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "other". Si noti che le modalità di viaggio bus, moto, taxi e furgoni sono funzionalità BETA. I dati di restrizione completi non sono disponibili in tutte le aree.

Nome	Tipo	Descrizione
bicycle	string	I percorsi restituiti sono ottimizzati per le biciclette, incluso l'uso di corsie per biciclette.
bus	string	I percorsi restituiti sono ottimizzati per gli autobus, incluso l'uso di solo corsie di autobus. Funzionalità BETA.
car	string	I percorsi restituiti sono ottimizzati per le auto.
motorcycle	string	I percorsi restituiti sono ottimizzati per le moto. Funzionalità BETA.
pedestrian	string	I percorsi restituiti sono ottimizzati per i pedoni, incluso l'uso di marciapiedi.
taxi	string	I percorsi restituiti sono ottimizzati per i taxi. Funzionalità BETA.
truck	string	I percorsi restituiti sono ottimizzati per i veicoli commerciali, come per i camion.
van	string	I percorsi restituiti sono ottimizzati per i furgoni. Funzionalità BETA.

VehicleEngineType

Tipo di motore del veicolo. Quando viene specificato un modello di consumo dettagliato, deve essere coerente con il valore di vehicleEngineType.

Nome	Tipo	Descrizione
combustion	string	Motore a combustione interna.
electric	string	Motore elettrico.

VehicleLoadType

Tipi di carico che possono essere classificati come materiali pericolosi e limitati da alcune strade. I valori di vehicleLoadType disponibili sono classi Us Hazmat da 1 a 9, oltre a classificazioni generiche da usare in altri paesi/aree geografiche. I valori che iniziano con USHazmat sono per il routing degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi/aree geografiche. vehicleLoadType può essere specificato più volte. Questo parametro è attualmente considerato solo per travelMode=truck.

Nome	Tipo	Descrizione
USHazmatClass1	string	Esplosivi
USHazmatClass2	string	Gas compresso
USHazmatClass3	string	Liquidi flammable
USHazmatClass4	string	Solidi flammable
USHazmatClass5	string	Ossidanti
USHazmatClass6	string	Veleni
USHazmatClass7	string	Radioattivo
USHazmatClass8	string	Corrosivi
USHazmatClass9	string	Misto
otherHazmatExplosive	string	Esplosivi
otherHazmatGeneral	string	Misto
otherHazmatHarmfulToWater	string	Dannoso per l'acqua

WindingnessLevel

Livello di turni per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.

Nome	Tipo	Descrizione
high	string	alto
low	string	basso
normal	string	normale