RouteGetRouteDirectionsQueryParamProperties interface

Pacchetto:

@azure-rest/maps-route

Proprietà

accelerationEfficiency	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	Controlla l'ottimalità, in relazione ai criteri di pianificazione specificati, delle alternative calcolate rispetto alla route di riferimento.
arriveAt	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	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	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	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	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	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	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	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	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	Specifica l'alimentazione corrente di carburante in litri. Valori sensibili: 55
decelerationEfficiency	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	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	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	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	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.
instructionsType	Se specificato, verranno restituite istruzioni aggiuntive. Si noti che il parametro instructionsType non può essere usato insieme a routeRepresentation=none.
language	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	Numero di route alternative desiderate da calcolare. Impostazione predefinita: 0, minimo: 0 e massimo: 5
maxChargeInkWh	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	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	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.
query	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.
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	Specifica la rappresentazione del set di route fornite come risposta.
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
traffic	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	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	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	Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.
vehicleCommercial	Indica se il veicolo viene utilizzato per scopi commerciali. I veicoli commerciali potrebbero non essere autorizzati a guidare su alcune strade.
vehicleEngineType	Tipo di motore del veicolo. Quando viene specificato un modello di consumo dettagliato, deve essere coerente con il valore di vehicleEngineType.
vehicleHeading	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	Altezza del veicolo in metri. Il valore 0 indica che le restrizioni di altezza non vengono considerate.
vehicleLength	Lunghezza del veicolo in metri. Il valore 0 indica che le restrizioni di lunghezza non vengono considerate.
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	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	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	Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.
windingness	Livello di turni per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con routeType=brivido.

Dettagli proprietà

accelerationEfficiency

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

accelerationEfficiency?: number

Valore della proprietà

number

alternativeType

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

alternativeType?: "anyRoute" | "betterRoute"

Valore della proprietà

"anyRoute" | "betterRoute"

arriveAt

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.

arriveAt?: string | Date

Valore della proprietà

string | Date

auxiliaryPowerInkW

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

auxiliaryPowerInkW?: number

Valore della proprietà

number

auxiliaryPowerInLitersPerHour

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

auxiliaryPowerInLitersPerHour?: number

Valore della proprietà

number

avoid

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.

avoid?: ("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

Valore della proprietà

("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

computeBestOrder

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.

computeBestOrder?: boolean

Valore della proprietà

boolean

computeTravelTimeFor

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

computeTravelTimeFor?: "none" | "all"

Valore della proprietà

"none" | "all"

constantSpeedConsumptionInkWhPerHundredkm

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.

constantSpeedConsumptionInkWhPerHundredkm?: string

Valore della proprietà

string

constantSpeedConsumptionInLitersPerHundredkm

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.

constantSpeedConsumptionInLitersPerHundredkm?: string

Valore della proprietà

string

currentChargeInkWh

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

currentChargeInkWh?: number

Valore della proprietà

number

currentFuelInLiters

Specifica l'alimentazione corrente di carburante in litri.

Valori sensibili: 55

currentFuelInLiters?: number

Valore della proprietà

number

decelerationEfficiency

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

decelerationEfficiency?: number

Valore della proprietà

number

departAt

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.

departAt?: string | Date

Valore della proprietà

string | Date

downhillEfficiency

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

downhillEfficiency?: number

Valore della proprietà

number

fuelEnergyDensityInMJoulesPerLiter

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

fuelEnergyDensityInMJoulesPerLiter?: number

Valore della proprietà

number

hilliness

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

hilliness?: "low" | "normal" | "high"

Valore della proprietà

"low" | "normal" | "high"

instructionsType

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

instructionsType?: "coded" | "text" | "tagged"

Valore della proprietà

"coded" | "text" | "tagged"

language

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

language?: string

Valore della proprietà

string

maxAlternatives

Numero di route alternative desiderate da calcolare. Impostazione predefinita: 0, minimo: 0 e massimo: 5

maxAlternatives?: number

Valore della proprietà

number

maxChargeInkWh

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

maxChargeInkWh?: number

Valore della proprietà

number

minDeviationDistance

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

minDeviationDistance?: number

Valore della proprietà

number

minDeviationTime

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.

minDeviationTime?: number

Valore della proprietà

number

query

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.

query: string

Valore della proprietà

string

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.

report?: "effectiveSettings"

Valore della proprietà

"effectiveSettings"

routeRepresentation

Specifica la rappresentazione del set di route fornite come risposta.

routeRepresentation?: "polyline" | "summaryOnly" | "none"

Valore della proprietà

"polyline" | "summaryOnly" | "none"

routeType

Tipo di route richiesto.

routeType?: "fastest" | "shortest" | "eco" | "thrilling"

Valore della proprietà

"fastest" | "shortest" | "eco" | "thrilling"

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

sectionType?: ("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

Valore della proprietà

("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

traffic

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.

traffic?: boolean

Valore della proprietà

boolean

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.

travelMode?: "pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

Valore della proprietà

"pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

uphillEfficiency

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

uphillEfficiency?: number

Valore della proprietà

number

vehicleAxleWeight

Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.

vehicleAxleWeight?: number

Valore della proprietà

number

vehicleCommercial

Indica se il veicolo viene utilizzato per scopi commerciali. I veicoli commerciali potrebbero non essere autorizzati a guidare su alcune strade.

vehicleCommercial?: boolean

Valore della proprietà

boolean

vehicleEngineType

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

vehicleEngineType?: "combustion" | "electric"

Valore della proprietà

"combustion" | "electric"

vehicleHeading

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

vehicleHeading?: number

Valore della proprietà

number

vehicleHeight

Altezza del veicolo in metri. Il valore 0 indica che le restrizioni di altezza non vengono considerate.

vehicleHeight?: number

Valore della proprietà

number

vehicleLength

Lunghezza del veicolo in metri. Il valore 0 indica che le restrizioni di lunghezza non vengono considerate.

vehicleLength?: number

Valore della proprietà

number

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.

vehicleLoadType?: "USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

Valore della proprietà

"USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

vehicleMaxSpeed

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.

vehicleMaxSpeed?: number

Valore della proprietà

number

vehicleWeight

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

vehicleWeight?: number

Valore della proprietà

number

vehicleWidth

Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.

vehicleWidth?: number

Valore della proprietà

number

windingness

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

windingness?: "low" | "normal" | "high"

Valore della proprietà

"low" | "normal" | "high"