Route - Get Route Range

Riferimento

Servizio:: Maps

Versione API:: 1.0

Usare per creare una mappa che illustra l'area accessibile da un determinato punto all'interno di una determinata soglia in base a tempo, distanza o capacità del carburante.

L'API Get Route Range (Isochrone) è una richiesta HTTP GET che calcola un set di posizioni che possono essere raggiunte dal punto di origine in base al budget di carburante, energia, tempo o distanza specificato. Un limite poligono (o Isocrona) viene restituito in un orientamento antiorario, nonché il centro poligono preciso che era il risultato del punto di origine.

Il poligono restituito può essere usato per un'ulteriore elaborazione, ad esempio Cerca all'interno della geometria , per cercare poI all'interno dell'isocrona specificata.

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

Con parametri facoltativi:

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&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	number[]	Coordinata da cui deve iniziare il calcolo dell'intervallo.
accelerationEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia chimica archiviata nel carburante all'energia cinetica quando il veicolo accelera (ad esempio cinetica EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed viene ottenuto convertendo il combustibile utilizzato in energia chimica usando il carburante EnergyDensityInMJoulesPerLiter. Deve essere associato alla deelerazioneEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/decelerationEfficiency. Valori sensibili : per il modello di combustione : 0,33, per il modello elettrico : 0,66
auxiliaryPowerInkW	query		number double	Specifica la quantità di energia utilizzata per sostenere i sistemi ausiliari, in kilowatts (kW). Può essere usato per specificare il consumo a causa di dispositivi e sistemi come sistemi a ac, radio, riscaldamento e così via. Valori sensibili : 1,7
auxiliaryPowerInLitersPerHour	query		number double	Specifica la quantità di carburante utilizzata 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 a 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 durante la determinazione della route. Può essere specificato più volte in una richiesta, ad esempio "&avoid=autostrade&evitare=caselli&evitare=traghetti". Nelle richieste dell'intervallo di route il valore giàUsedRoads non deve essere usato.
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 in una curva di consumo. Le tariffe di consumo per le velocità non presenti nell'elenco sono disponibili come segue: per interpolazione lineare, se la velocità specificata si trova tra due velocità nell'elenco 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 (inclusivo) e potrebbe non contenere punti duplicati per la stessa velocità. Se contiene solo un singolo punto, il tasso di consumo di tale punto viene usato senza ulteriore elaborazione. Il consumo specificato per la velocità più grande deve essere maggiore o uguale a quello della penultimo velocità più grande. Ciò garantisce che l'estrapolazione non comporta tassi di consumo negativi. Analogamente, i valori di consumo specificati per le due velocità più piccole nell'elenco non possono causare una velocità di consumo negativa per una 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 è necessario per il modello di consumo elettrico.
constantSpeedConsumptionInLitersPerHundredkm	query		string	Specifica il componente dipendente dalla velocità del consumo. Fornito come elenco non ordinato di velocità delimitata da punti & coppie a velocità di consumo. L'elenco definisce i punti in una curva di consumo. Le tariffe di consumo per le velocità non presenti nell'elenco sono disponibili come segue: per interpolazione lineare, se la velocità specificata si trova tra due velocità nell'elenco 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 (inclusivo) e potrebbe non contenere punti duplicati per la stessa velocità. Se contiene solo un singolo punto, il tasso di consumo di tale punto viene usato senza ulteriore elaborazione. Il consumo specificato per la velocità più grande deve essere maggiore o uguale a quello della penultimo velocità più grande. Ciò garantisce che l'estrapolazione non comporta tassi di consumo negativi. Analogamente, i valori di consumo specificati per le due velocità più piccole nell'elenco non possono causare una velocità di consumo negativa per una 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 il modello di consumo di combustione.
currentChargeInkWh	query		number double	Specifica l'alimentazione elettrica corrente in kilowatt ore (kWh). Questo parametro esiste con il parametro maxChargeInkWh . L'intervallo di valori consentiti è 0,0 a maxChargeInkWh. Valori sensibili : 43
currentFuelInLiters	query		number double	Specifica la fornitura corrente di carburante in litri. Valori sensibili : 55
decelerationEfficiency	query		number double	Specifica l'efficienza della conversione dell'energia cinetica in carburante salvato (non usato) quando il veicolo decelerate (ad esempio Chemical EnergySaved/Cine EnergyLost). Chemical EnergySaved viene ottenuto convertendo il combustibile salvato (non usato) in energia usando il carburante EnergyDensityInMJoulesPerLiter. Deve essere associato all'accelerazioneEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/accelerazionE. Valori sensibili : per il modello di combustione : 0,83, per il modello elettrico : 0,91
departAt	query		string date-time	Data e ora di partenza dal punto di origine formattato come `dateTime` valore 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-20T00:39:57+00:00 Il `departAt` parametro non può essere usato insieme a `arriveAt`.
distanceBudgetInMeters	query		number double	Budget della distanza in metri che determina l'intervallo massimo che può essere viaggiato utilizzando la distanza di guida. Il modello a consumo influirà solo sull'intervallo quando routeType è eco. È necessario usare esattamente un budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
downhillEfficiency	query		number double	Specifica l'efficienza della conversione di energia potenziale in carburante salvato (non utilizzato) quando il veicolo perde l'elevazione (ad esempio Chemical EnergySaved/Potential EnergyLost). Chemical EnergySaved viene ottenuto convertendo il combustibile salvato (non usato) in energia usando il carburante EnergyDensityInMJoulesPerLiter. Deve essere associato a una salitaEfficienza. L'intervallo di valori consentiti è compreso tra 0,0 e 1/in salita. Valori sensibili : per il modello di combustione : 0,51, per il modello elettrico : 0,73
energyBudgetInkWh	query		number double	Budget energetico elettrico in kilowatt ore (kWh) che determina l'intervallo massimo che può essere viaggiato utilizzando il modello di consumo elettrico specificato. Quando viene usato energyBudgetInkWh, è obbligatorio specificare un modello di consumo elettrico dettagliato. È necessario usare esattamente un budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
fuelBudgetInLiters	query		number double	Budget del carburante in litri che determina l'intervallo massimo che può essere viaggiato utilizzando il modello di consumo di combustione specificato. Quando si utilizza fuelBudgetInLiters, è obbligatorio specificare un modello dettagliato di consumo a combustione. È necessario usare esattamente un budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
fuelEnergyDensityInMJoulesPerLiter	query		number double	Specifica la quantità di energia chimica archiviata in un litro di carburante in megajoules (MJ). Viene usato insieme ai parametri *Efficienza per le conversioni tra energia salvata o consumata energia e carburante. Ad esempio, la densità energetica è 34,2 MJ/l per benzina e 35,8 MJ/l per carburante diesel. Questo parametro è obbligatorio se è impostato un parametro *Efficienza . Valori sensibili : 34.2
hilliness	query		InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con `routeType`=brivido.
maxChargeInkWh	query		number double	Specifica l'alimentazione elettrica massima in kilowatt ore (kWh) che possono essere archiviate nella batteria del veicolo. Questo parametro esiste con il parametro currentChargeInkWh . Il valore minimo deve essere maggiore o uguale a currentChargeInkWh. Valori sensibili : 85
routeType	query		RouteType	Tipo di route richiesto.
timeBudgetInSec	query		number double	Budget del tempo in secondi che determina l'intervallo massimo che può essere viaggiato utilizzando il tempo di guida. Il modello a consumo influirà solo sull'intervallo quando routeType è eco. È necessario usare esattamente un budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
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, anche se i dati sul traffico correnti vengono ignorati durante il routing, l'effetto del traffico cronologico 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 il travelMode richiesto potrebbe non essere disponibile per l'intero itinerario. Se il travelMode richiesto 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 furgone 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 archiviata in carburante a potenziale energia quando il veicolo aumenta l'elevazione (ad esempio Potenziale EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed viene ottenuto convertendo il combustibile utilizzato in energia chimica usando il carburante EnergyDensityInMJoulesPerLiter. Deve essere associato a un'efficienza in discesa. L'intervallo di valori consentiti è da 0,0 a 1/discesaEfficiency. Valori sensibili : per il modello di combustione : 0,27, per il modello elettrico : 0,74
vehicleAxleWeight	query		integer	Peso per asse del veicolo in kg. Un valore pari a 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.
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 vehicleLoadType disponibili sono le classi Us Hazmat da 1 a 9, oltre alle 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. Durante la pianificazione della route è possibile eseguire l'override di un valore diverso da zero. 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 come questa è la 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 chilogrammi. È obbligatorio se sono impostati uno dei parametri Efficiency. Deve essere strettamente positivo se usato nel contesto del modello a consumo. Vengono considerate restrizioni di peso. Se non viene specificato alcun modello di consumo* dettagliato e il valore di vehicleWeight è diverso da zero, vengono considerate le restrizioni di peso. In tutti gli altri casi, questo parametro viene ignorato. Valori sensibili : per il modello di combustione : 1600, per il 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 l'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 del piano di gestione mappe di Azure. Per usare la sicurezza di Microsoft Entra ID in Mappe di Azure, vedere gli articoli seguenti per indicazioni.

Risposte

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

Sicurezza

AADToken

Si tratta dei flussi Microsoft Entra OAuth 2.0 . Se abbinato al controllo degli accessi in base al ruolo di Azure , 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 i 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 mappe.

è Authorization URL specifico dell'istanza del cloud pubblico di Azure. I cloud sovrani hanno URL di autorizzazione univoci e configurazioni ID Microsoft Entra. * 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 di Azure Maps Web SDK 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 crea un account 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 alle 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 Elenca firma di accesso condiviso nella risorsa 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 con i controlli di accesso in base al ruolo di Azure e il controllo granulare alla scadenza, alla frequenza e alle 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 dell'account map per limitare l'abuso di rendering e rinnovare regolarmente il token di firma di accesso condiviso.

Tipo: apiKey
In: header

Esempio

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Esempio di richiesta

HTTP

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Risposta di esempio

Codice di stato:: 200

{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Definizioni

Nome	Descrizione
EffectiveSetting	Parametro o dati effettivi usati quando si chiama questa API di route.
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con `routeType`=thrilling.
LatLongPair	Una posizione rappresentata come latitudine e longitudine.
ResponseFormat	Formato desiderato della risposta. Il valore può essere json o xml.
RouteAvoidType	Specifica un elemento che il calcolo della route deve cercare di evitare quando si determina la route. È possibile specificare più volte in una richiesta, ad esempio "&evitare=autostrada&evitare=pedaggio&evitare=ferry". Nelle richieste Di intervallo di route il valore giàUsedRoads non deve essere usato.
RouteRange	Intervallo raggiungibile
RouteRangeResult	Questo oggetto viene restituito da una chiamata Route Reachable Range riuscita
RouteReport	Segnala le impostazioni effettive usate nella chiamata corrente.
RouteType	Tipo di route richiesto.
TravelMode	Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è 'car'. Si noti che il travelMode richiesto potrebbe non essere disponibile per l'intera route. Se il travelMode richiesto non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "altro". Si noti che le modalità di viaggio bus, moto, taxi e furgone 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 turno per un percorso emozionante. Questo parametro può essere usato solo in combinazione con `routeType`=thrilling.

EffectiveSetting

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

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

ErrorAdditionalInfo

Informazioni aggiuntive sulla 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.

InclineLevel

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

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

LatLongPair

Una posizione rappresentata come latitudine e longitudine.

Nome	Tipo	Descrizione
latitude	number	Latitudine, proprietà
longitude	number	Proprietà Longitudine

ResponseFormat

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

Nome	Tipo	Descrizione
json	string	Formato di interscambio dati dell'oggetto JavaScript
xml	string	Linguaggio di markup estendibile

RouteAvoidType

Specifica un elemento che il calcolo della route deve cercare di evitare quando si determina la route. È possibile specificare più volte in una richiesta, ad esempio "&evitare=autostrada&evitare=pedaggio&evitare=ferry". 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 i passaggi di frontiera nel calcolo della route.
carpools	string	Evita percorsi che richiedono l'uso di carpool (HOV/High Occupancy Vehicle) corsie.
ferries	string	Evita i traghetti
motorways	string	Evita le autostrade
tollRoads	string	Evita le strade a pedaggio.
unpavedRoads	string	Evita strade non pavimentate

RouteRange

Intervallo raggiungibile

Nome	Tipo	Descrizione
boundary	LatLongPair[]	Limite poligono dell'intervallo raggiungibile rappresentato come elenco di punti.
center	LatLongPair	Punto centrale dell'intervallo raggiungibile

RouteRangeResult

Questo oggetto viene restituito da una chiamata Route Reachable Range riuscita

Nome	Tipo	Descrizione
formatVersion	string	Format Version, proprietà
reachableRange	RouteRange	Intervallo raggiungibile
report	RouteReport	Segnala le impostazioni effettive usate nella chiamata corrente.

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.

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 usa il minor numero possibile di autostrade. È possibile scegliere il livello di turni incluso e anche il grado di collina. Vedere i parametri di salita e di avvolgimento per come impostare questa operazione. C'è un limite di 900 km su itinerari pianificati con `routeType`=emozionante

TravelMode

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

Nome	Tipo	Descrizione
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 automobili.
motorcycle	string	Le route restituite sono ottimizzate per le moto. Funzionalità BETA.
taxi	string	Le route restituite sono ottimizzate per i taxi. Funzionalità BETA.
truck	string	I percorsi restituiti sono ottimizzati per i veicoli commerciali, come per i camion.
van	string	Le route restituite sono ottimizzate 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 di 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	Solid flammable
USHazmatClass5	string	Oxidizers
USHazmatClass6	string	Veleni
USHazmatClass7	string	Radioattivo
USHazmatClass8	string	Corrosivi
USHazmatClass9	string	Varie
otherHazmatExplosive	string	Esplosivi
otherHazmatGeneral	string	Varie
otherHazmatHarmfulToWater	string	Dannoso per l'acqua

WindingnessLevel

Livello di turno per un percorso emozionante. Questo parametro può essere usato solo in combinazione con routeType=thrilling.

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

Condividi tramite