Route - Get Route Range

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à di carburante.

Nota

ritiro del servizio Route v1 di Mappe di Azure

Il servizio Route v1 di Mappe di Azure v 1 è ora deprecato e verrà ritirato il 3/31/28. Per evitare interruzioni del servizio, tutte le chiamate al servizio Route v1 dovranno essere aggiornate per usare Route v2025-01-01 servizio entro il 3/31/28. Per altre informazioni, vedere Migrate Azure Maps Route 1.0 API.

L'API Get Route Range (Isochrone) è una richiesta HTTP GET che calcolerà un set di posizioni che è possibile raggiungere 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 ricerca all'interno della geometria per cercare le interfacce POI all'interno della 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) minimum: 0 maximum: 1	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
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.
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) minimum: 0 maximum: 1	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`.
distanceBudgetInMeters	query		number (double)	Budget di distanza in metri che determina l'intervallo massimo che può essere viaggiato usando 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) minimum: 0 maximum: 1	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
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 di consumo di combustione dettagliato. È necessario usare esattamente un budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec o distanceBudgetInMeters).
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.
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
routeType	query		RouteType	Tipo di route richiesto.
timeBudgetInSec	query		number (double)	Budget di 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, 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) minimum: 0 maximum: 1	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.
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	Indica l'account destinato all'uso con il modello di sicurezza ID Microsoft Entra. Questo ID univoco per l'account Mappe di Azure può essere ottenuto dall'API Account del piano di gestione di Mappe di Azure. Per altre informazioni sull'uso della sicurezza dell'ID Microsoft Entra in Mappe di Azure, vedere Gestire l'autenticazione in Mappe di Azure.

Risposte

Nome	Tipo	Descrizione
200 OK	RouteRangeResult	Va bene
Other Status Codes	ErrorResponse	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 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 sull'errore di 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`=brivido.
LatLongPair	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 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.
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 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.

EffectiveSetting

Object

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

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

InclineLevel

Enumerazione

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

Valore	Descrizione
low	basso
normal	normale
high	alto

LatLongPair

Object

Posizione rappresentata come latitudine e longitudine.

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

ResponseFormat

Enumerazione

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

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

RouteAvoidType

Enumerazione

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.

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

RouteRange

Object

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

Object

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

Object

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

Enumerazione

Tipo di route richiesto.

Valore	Descrizione
fastest	Percorso più veloce.
shortest	Percorso più breve per distanza.
eco	Un percorso bilanciato dall'economia e dalla velocità.
thrilling	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

TravelMode

Enumerazione

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.

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

VehicleEngineType

Enumerazione

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

Valore	Descrizione
combustion	Motore a combustione interna.
electric	Motore elettrico.

VehicleLoadType

Enumerazione

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.

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

WindingnessLevel

Enumerazione

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

Valore	Descrizione
low	basso
normal	normale
high	alto

Condividi tramite

Route - Get Route Range

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

AADToken

Note

Ambiti

subscription-key

SAS Token

Esempio

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

Esempio di richiesta

Risposta di esempio

Definizioni

EffectiveSetting

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InclineLevel

LatLongPair

ResponseFormat

RouteAvoidType

RouteRange

RouteRangeResult

RouteReport

RouteType

TravelMode

VehicleEngineType

VehicleLoadType

WindingnessLevel