Route - Post Route Matrix

Riferimento

Servizio:: Maps

Versione API:: 1.0

Usare per ottenere una matrice di itinerari che mostra il tempo di viaggio e la distanza per tutte le coppie possibili in un elenco di origini e destinazioni, usando una richiesta asincrona.

L'API Post Route Matrix è una richiesta http POST che consente il calcolo di una matrice di riepiloghi di route per un set di route definite dalle posizioni di origine e di destinazione usando una richiesta asincrona (asincrona). Per effettuare una richiesta sincrona (sincrona), vedere Post Route Matrix Sync. Per ogni origine specificata, il servizio calcola il costo del routing da tale origine a ogni destinazione specificata. Il set di origini e il set di destinazioni possono essere considerati come le intestazioni di colonna e riga di una tabella e ogni cella della tabella contiene i costi di routing dall'origine alla destinazione per tale cella. Ad esempio, si supponga che un'azienda di consegna alimentare abbia 20 conducenti e che debbano trovare il conducente più vicino per prendere la consegna dal ristorante. Per risolvere questo caso d'uso, è possibile chiamare l'API Route matrix.

Per ogni itinerario, vengono restituiti i tempi di viaggio e le distanze. È possibile usare i costi calcolati per determinare quali route dettagliate calcolare usando l'API Indicazioni stradali.

La dimensione massima di una matrice per una richiesta asincrona è 700 e per la richiesta di sincronizzazione è 100 (il numero di origini moltiplicato per il numero di destinazioni).

Nota

Tutte le origini e le destinazioni devono essere contenute in un rettangolo delimitatore di 400 km x 400 km. In caso contrario, alcune celle della matrice verranno risolte come OUT_OF_REGION.

Invia richiesta matrice di route sincrona

Se lo scenario richiede richieste sincrone e la dimensione massima della matrice è minore o uguale a 100, potrebbe essere necessario effettuare una richiesta sincrona. La dimensione massima di una matrice per questa API è 100 (il numero di origini moltiplicato per il numero di destinazioni). Tenendo presente tale vincolo, alcuni esempi di possibili dimensioni della matrice sono: 10x10, 6x8, 9x8 (non deve essere quadrato).

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

Invia richiesta matrice di route asincrona

L'API asincrona è appropriata per l'elaborazione di grandi volumi di richieste di routing relativamente complesse. Quando si effettua una richiesta usando una richiesta asincrona, per impostazione predefinita il servizio restituisce un codice di risposta 202 lungo un URL di reindirizzamento nel campo Percorso dell'intestazione della risposta. Questo URL deve essere controllato periodicamente fino a quando non sono disponibili i dati di risposta o le informazioni sull'errore. Se waitForResults parametro nella richiesta è impostato su true, l'utente riceverà una risposta 200 se la richiesta viene completata in meno di 120 secondi.

La dimensione massima di una matrice per questa API è 700 (il numero di origini moltiplicato per il numero di destinazioni). Tenendo presente tale vincolo, alcuni esempi di possibili dimensioni della matrice sono: 50x10, 10x10, 28x25. 10x70 (non deve essere quadrato).

Le risposte asincrone vengono archiviate per 24 ore. L'URL di reindirizzamento restituisce una risposta 404 se usata dopo il periodo di scadenza.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

Ecco una sequenza tipica di operazioni asincrone:

Il client invia una richiesta POST matrice di route a Mappe di Azure
Il server risponderà con uno dei seguenti elementi:

Http 202 Accepted - Richiesta matrice di route accettata.

HTTP Error: si è verificato un errore durante l'elaborazione della richiesta matrice di route. Potrebbe trattarsi di una richiesta non valida 400 o di qualsiasi altro codice di stato errore.
Se la richiesta di route matrice è stata accettata correttamente, l'intestazione Location nella risposta contiene l'URL per scaricare i risultati della richiesta. Questo URI di stato è simile al seguente:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

Il client invia una richiesta GET sull'URL di download ottenuto nel passaggio 3 per scaricare i risultati

Scaricare i risultati della sincronizzazione

Quando si effettua una richiesta POST per l'API di sincronizzazione matrice di route, il servizio restituisce il codice di risposta 200 per la richiesta riuscita e una matrice di risposte. Il corpo della risposta conterrà i dati e non sarà possibile recuperare i risultati in un secondo momento.

Scaricare i risultati asincroni

Quando una richiesta invia una risposta 202 Accepted, la richiesta viene elaborata usando la pipeline asincrona. Verrà assegnato un URL per controllare lo stato di avanzamento della richiesta asincrona nell'intestazione del percorso della risposta. Questo URI di stato è simile al seguente:

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

L'URL fornito dall'intestazione della posizione restituirà le risposte seguenti quando viene emessa una richiesta di GET.

HTTP 202 Accepted: la richiesta matrice è stata accettata ma è ancora in corso di elaborazione. Riprovare in qualche tempo.

HTTP 200 OK: la richiesta di matrice è stata elaborata correttamente. Il corpo della risposta contiene tutti i risultati.

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0

Con parametri facoltativi:

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}&sectionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
format	path	True	JsonFormat	Formato desiderato della risposta. È supportato solo `json` formato.
api-version	query	True	string	Numero di versione dell'API mappe di Azure.
arriveAt	query		string date-time	Data e ora di arrivo nel punto di destinazione formattato come valore `dateTime` definito in RFC 3339, sezione 5.6, con una differenza di fuso orario facoltativa. Quando non viene specificata una differenza di fuso orario, si presuppone che sia quella del punto di destinazione. Esempi: 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 Il parametro `arriveAt` non può essere usato insieme a `departAt`, `minDeviationDistance` o `minDeviationTime`.
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.
computeTravelTimeFor	query		ComputeTravelTime	Specifica se restituire tempi di viaggio aggiuntivi usando tipi diversi di informazioni sul traffico (none, cronologia, dinamica) e il tempo di viaggio migliore predefinito.
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`.
hilliness	query		InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con `routeType`=brivido.
routeType	query		RouteType	Tipo di route richiesto.
sectionType	query		SectionType[]	Specifica quale dei tipi di sezione viene segnalato nella risposta di route. Ad esempio, se sectionType = le sezioni pedonali adatte ai pedoni vengono restituite solo. Può essere specificato più volte in una richiesta, ad esempio '§ionType=carTrain§ionType=pedestrian§ionType=autostrada'. La sezione predefinitaType fa riferimento all'input travelMode. Per impostazione predefinita travelMode è impostato su auto
traffic	query		boolean	Valori possibili: true - Prendere in considerazione tutte le informazioni sul traffico disponibili durante il routing false: ignorare i dati correnti del traffico durante il routing. Si noti che, sebbene i dati di traffico correnti vengano ignorati durante il routing, l'effetto del traffico storico sulle velocità effettive della strada è ancora incorporato.
travelMode	query		TravelMode	Modalità di viaggio per il percorso richiesto. Se non definito, il valore predefinito è 'car'. Si noti che l'oggetto travelMode richiesto potrebbe non essere disponibile per l'intera route. Se la proprietà travelMode richiesta non è disponibile per una sezione specifica, l'elemento travelMode della risposta per tale sezione sarà "other". Si noti che le modalità di viaggio bus, moto, taxi e furgoni sono funzionalità BETA. I dati di restrizione completi non sono disponibili in tutte le aree.
vehicleAxleWeight	query		integer	Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.
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.
vehicleWidth	query		number double	Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.
waitForResults	query		boolean	Valore booleano per indicare se eseguire la richiesta in modo sincrono. Se impostato su true, l'utente riceverà una risposta di 200 se la richiesta viene completata in meno di 120 secondi. In caso contrario, l'utente riceverà immediatamente una risposta 202. Per altri dettagli sulla risposta 202, vedere la descrizione dell'API. Supportato solo per la richiesta asincrona.
windingness	query		WindingnessLevel	Livello di turni per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con `routeType`=brivido.

Intestazione della richiesta

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

Corpo della richiesta

Nome	Tipo	Descrizione
destinations	GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.
origins	GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.

Risposte

Nome	Tipo	Descrizione
200 OK	RouteMatrixResult	Richiesta matrice elaborata correttamente. Il corpo della risposta contiene tutti i risultati.
202 Accepted		Supportato solo per la richiesta asincrona. Richiesta accettata: la richiesta è stata accettata per l'elaborazione. Usare l'URL nell'intestazione percorso per riprovare o accedere ai risultati. Intestazioni Location: string
Other Status Codes	ErrorResponse	Si è verificato un errore imprevisto.

Nome

Tipo

Descrizione

200 OK

RouteMatrixResult

Richiesta matrice elaborata correttamente. Il corpo della risposta contiene tutti i risultati.

202 Accepted

Supportato solo per la richiesta asincrona. Richiesta accettata: la richiesta è stata accettata per l'elaborazione. Usare l'URL nell'intestazione percorso per riprovare o accedere ai risultati.

Intestazioni

Location: string

Other Status Codes

ErrorResponse

Si è verificato un errore imprevisto.

Sicurezza

AADToken

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

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

Note

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

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

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

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

Ambiti

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

subscription-key

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

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

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

Tipo: apiKey
In: query

SAS Token

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

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

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

Tipo: apiKey
In: header

Esempio

Successfully submit a route matrix request

Esempio di richiesta

HTTP

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest

{
  "origins": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85106,
        52.36006
      ],
      [
        4.85056,
        52.36187
      ]
    ]
  },
  "destinations": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85003,
        52.36241
      ],
      [
        13.42937,
        52.50931
      ]
    ]
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "formatVersion": "0.0.1",
  "matrix": [
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 495,
            "travelTimeInSeconds": 134,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:43+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647651,
            "travelTimeInSeconds": 26835,
            "trafficDelayInSeconds": 489,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:22:44+00:00"
          }
        }
      }
    ],
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 338,
            "travelTimeInSeconds": 104,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:13+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647494,
            "travelTimeInSeconds": 26763,
            "trafficDelayInSeconds": 469,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:21:32+00:00"
          }
        }
      }
    ]
  ],
  "summary": {
    "successfulRoutes": 4,
    "totalRoutes": 4
  }
}

Codice di stato:: 202

operation-Location: New URL to check the status of the long-running operation.

Definizioni

Nome	Descrizione
ComputeTravelTime	Specifica se restituire tempi di viaggio aggiuntivi usando tipi diversi di informazioni sul traffico (none, cronologia, dinamica) e il tempo di viaggio migliore predefinito.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.
InclineLevel	Grado di collina per itinerari emozionanti. Questo parametro può essere usato solo in combinazione con `routeType`=brivido.
JsonFormat	Formato desiderato della risposta. È supportato solo `json` formato.
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.
RouteLegSummary	Oggetto riepilogo per la sezione route.
RouteMatrix	Oggetto risultato matrice
RouteMatrixQuery	Oggetto con una matrice di coordinate.
RouteMatrixResult	Questo oggetto viene restituito da una chiamata di Route Matrix riuscita. Ad esempio, se vengono fornite 2 origini e 3 destinazioni, ci saranno 2 matrici con 3 elementi in ognuno. Il contenuto di ogni elemento dipende dalle opzioni disponibili nella query.
RouteMatrixResultResponse	Oggetto risposta della cella corrente nella matrice di input.
RouteMatrixSummary	Oggetto Riepilogo
RouteType	Tipo di route richiesto.
SectionType	Specifica quale dei tipi di sezione viene segnalato nella risposta di route. Ad esempio, se sectionType = le sezioni pedonali adatte ai pedoni vengono restituite solo. Può essere specificato più volte in una richiesta, ad esempio '§ionType=carTrain§ionType=pedestrian§ionType=autostrada'. La sezione predefinitaType fa riferimento all'input travelMode. Per impostazione predefinita travelMode è impostato su auto
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.
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.

ComputeTravelTime

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

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

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Dettagli dell'errore.

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

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

GeoJsonMultiPoint

Tipo geometry GeoJSON MultiPoint valido. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[]	Coordinate per la geometria `GeoJson MultiPoint`.
type	string: MultiPoint	Specifica il tipo di `GeoJSON`. Deve essere uno dei nove tipi di oggetto GeoJSON validi: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature e FeatureCollection.

InclineLevel

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

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

JsonFormat

Formato desiderato della risposta. È supportato solo json formato.

Nome	Tipo	Descrizione
json	string	il formato dell'interscambio dati notazione oggetto JavaScript

RouteAvoidType

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

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

RouteLegSummary

Oggetto riepilogo per la sezione route.

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

RouteMatrix

Oggetto risultato matrice

Nome	Tipo	Descrizione
response	RouteMatrixResultResponse	Oggetto risposta della cella corrente nella matrice di input.
statusCode	integer	Proprietà StatusCode per la cella corrente nella matrice di input.

RouteMatrixQuery

Oggetto con una matrice di coordinate.

Nome	Tipo	Descrizione
destinations	GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.
origins	GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.

RouteMatrixResult

Questo oggetto viene restituito da una chiamata di Route Matrix riuscita. Ad esempio, se vengono fornite 2 origini e 3 destinazioni, ci saranno 2 matrici con 3 elementi in ognuno. Il contenuto di ogni elemento dipende dalle opzioni disponibili nella query.

Nome	Tipo	Descrizione
formatVersion	string	Format Version - proprietà
matrix	RouteMatrix[]	Risultati come matrice bidimensionale di riepiloghi di route.
summary	RouteMatrixSummary	Oggetto Riepilogo

RouteMatrixResultResponse

Oggetto risposta della cella corrente nella matrice di input.

Nome	Tipo	Descrizione
routeSummary	RouteLegSummary	Oggetto riepilogo per la sezione route.

RouteMatrixSummary

Oggetto Riepilogo

Nome	Tipo	Descrizione
successfulRoutes	integer	Numero di route riuscite nella risposta.
totalRoutes	integer	Numero totale di route richieste. Numero di celle nella matrice di input.

RouteType

Tipo di route richiesto.

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

SectionType

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

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

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

TravelMode

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

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

VehicleLoadType

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

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

WindingnessLevel

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

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

Condividi tramite

Route - Post Route Matrix

Invia richiesta matrice di route sincrona

Invia richiesta matrice di route asincrona

Scaricare i risultati della sincronizzazione

Scaricare i risultati asincroni

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

AADToken

Note

Ambiti

subscription-key

SAS Token

Esempio

Successfully submit a route matrix request

Esempio di richiesta

Risposta di esempio

Definizioni

ComputeTravelTime

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeoJsonMultiPoint

InclineLevel

JsonFormat

RouteAvoidType

RouteLegSummary

RouteMatrix

RouteMatrixQuery

RouteMatrixResult

RouteMatrixResultResponse

RouteMatrixSummary

RouteType

SectionType

TravelMode

VehicleLoadType

WindingnessLevel

Risorse aggiuntive