Route - Post Route Matrix Async

Riferimento

Servizio:: Maps

Versione API:: 2025-01-01

L'API Route Matrix Async è 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 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. Le matrici di itinerari possono essere calcolate per guidare, camminare e autocarri.

Le matrici di route vengono usate in diversi tipi di applicazioni, in genere per risolvere il problema TSP (Traveling Salesman Problem) e Il problema di routing dei veicoli . Per ogni coppia di destinazione di origine nella matrice, vengono restituiti il tempo di viaggio e la distanza. È 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 è 50000 (il numero di origini moltiplicato per il numero di destinazioni).

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 nel campo operation-Location dell'intestazione della risposta con l'endpoint geografico di Mappe di Azure '{geography}.atlas.microsoft.com. Questo URL deve essere controllato periodicamente fino a quando lo stato non è Succeeded.

La dimensione massima di una matrice per questa API è 50000 (il numero di origini moltiplicato per il numero di destinazioni). Tenendo presente tale vincolo, esempi di possibili dimensioni della matrice sono: 500x100, 100x100, 280x170. 100x50 (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:async?api-version=2025-01-01&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 operation-location nella risposta contiene l'URL per ottenere lo stato della richiesta. Questo URI di stato è simile al seguente:

  GET https://atlas.microsoft.com/route/operations/{id}?api-version=2025-01-01?subscription-key={subscription-key}

Il client invia una richiesta GET sul risultatoUrl ottenuto nel passaggio 3 per ottenere i risultati

  GET https://atlas.microsoft.com/route/operations/{id}/result?api-version=2025-01-01?subscription-key={subscription-key}

Limitazioni api

L'elaborazione asincrona della matrice è più adatta per matrici di dimensioni maggiori che richiedono calcoli di route pesanti. La limitazione seguente è applicabile alle richieste asincrone. Se nessuna delle righe nella tabella seguente corrisponde ai parametri della richiesta, la richiesta non soddisfa i requisiti e non verrà elaborata.

Dimensioni massime matrice	Numero massimo di origini	Numero massimo di destinazioni	Limiti aggiuntivi
2500	1000	1000	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.
50,000	10,000	10,000	- `departAt` o `arriveAt` devono essere presenti. - `traffic` deve essere cronologico. - `optimizeRoute` deve essere più veloce. - `travelMode` deve essere guidata o camion. - Non è possibile usare altri parametri in modo esplicito.

POST https://atlas.microsoft.com/route/matrix:async?api-version=2025-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Numero di versione dell'API mappe di Azure.

Intestazione della richiesta

Media Types: "application/geo+json"

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

Media Types: "application/geo+json"

Nome	Necessario	Tipo	Descrizione
features	True	InputRouteMatrixFeaturesItem[]	Set di punti di origine e di destinazione passati come funzionalità MultiPoint GeoJSON per la matrice di input. Per informazioni dettagliate sul formato GeoJSON, vedere RFC 7946.
type	True	FeatureTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è `FeatureCollection`. Per altre informazioni, vedere RFC 7946.
arriveAt		string	Data e ora di arrivo nel punto di destinazione formattato come valore `dateTime` definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC. Il parametro `arriveAt` non può essere utilizzato insieme a `departAt`. Il `arriveAt` supporta anche `any` valore personalizzato per il caso d'uso in cui il contesto temporale è irrilevante. Il valore del parametro `traffic=live` non può essere usato insieme a `any`. Valore predefinito: `any` se `arriveAt` non è specificato. Esempio: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid		RouteMatrixAvoidEnum[]	Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.
departAt		string	Data e ora di partenza dal punto di origine formattato come valore `dateTime` definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC. Il parametro `departAt` non può essere utilizzato insieme a `arriveAt`. Il `departAt` supporta anche: `any` valore personalizzato per il caso d'uso in cui il contesto temporale è irrilevante. Il valore del parametro `traffic=live` non può essere usato insieme a `any`. `now` valore per impostare l'ora di partenza sul tempo di elaborazione di ogni singola cella. Il tempo di elaborazione può essere in qualsiasi momento tra l'invio e il completamento. Questa modalità viene usata meglio insieme a traffic=live. Valore predefinito: `any` se `departAt` non è specificato. Esempio: "departAt": "2024-12-01T09:30:00.000-07:00"
optimizeRoute		RouteMatrixAsyncOptimizeRouteEnum	Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "più veloce" che restituisce il percorso per ridurre al minimo il tempo di viaggio. Esempio: "optimizeRoute":"shortest"
traffic		RouteMatrixTrafficEnum	Specifica il modo in cui viene considerato il traffico per le route di calcolo. Valore predefinito: `historical`
travelMode		RouteMatrixTravelModeEnum	Specifica il profilo di viaggio da considerare durante il calcolo della matrice. Se non specificato, il valore predefinito è "driving". Esempio: "travelMode":"driving"
vehicleSpec		RouteMatrixVehicleSpec	Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo della matrice di itinerario. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, curve a destra difficili per fornire il percorso ottimizzato in base alle specifiche del veicolo. Gli attributi del veicolo vengono specificati all'interno della proprietà vehicleSpec.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Accettato Intestazioni Operation-Location: string
Other Status Codes	MapsErrorResponse	Errore imprevisto. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

202 Accepted

Accettato

Intestazioni

Operation-Location: string

Other Status Codes

MapsErrorResponse

Errore imprevisto.

Intestazioni

x-ms-error-code: string

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.

Nota

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 della 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 durante la creazione di un 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 questa chiave, qualsiasi applicazione è autorizzata ad accedere a tutte le API REST. In altre parole, questi possono essere attualmente considerati chiavi master per l'account per cui vengono rilasciati.

Per le applicazioni esposte pubblicamente, è consigliabile usare l'accesso da server a server delle API REST di Mappe di Azure in cui questa chiave può essere archiviata in modo sicuro.

Tipo: apiKey
In: header

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

Submit an asynchronous request for matrix

Esempio di richiesta

HTTP

POST https://atlas.microsoft.com/route/matrix:async?api-version=2025-01-01

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            9.15049,
            45.458545
          ],
          [
            11.050541,
            45.403337
          ]
        ]
      },
      "properties": {
        "pointType": "origins"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "MultiPoint",
        "coordinates": [
          [
            11.499931,
            48.149853
          ],
          [
            14.538226,
            50.033688
          ]
        ]
      },
      "properties": {
        "pointType": "destinations"
      }
    }
  ],
  "departAt": "2022-12-19T16:39:57+01:00",
  "optimizeRoute": "fastest",
  "traffic": "historical",
  "travelMode": "truck",
  "avoid": [
    "unpavedRoads"
  ]
}

Risposta di esempio

Codice di stato:: 202

Operation-Location: https://atlas.microsoft.com/route/operations/bc3f9365-3ee0-4564-aa27-825016325557?api-version=2025-01-01

Definizioni

Nome	Descrizione
AdrTunnelRestrictionCodeEnum	Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.
FeaturesItemTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.
FeatureTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è `FeatureCollection`. Per altre informazioni, vedere RFC 7946.
GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.
InputRouteMatrixFeaturesItem	Specifica l'origine di input e i punti di destinazione e le proprietà aggiuntive per l'oggetto funzionalità multipoint `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
InputRouteMatrixProperties	Specifica l'oggetto proprietà per la matrice di input.
MapsErrorDetail	Dettagli dell'errore.
MapsErrorResponse	Risposta di errore comune per le API di Mappe di Azure per restituire i dettagli dell'errore per le operazioni non riuscite.
MapsInnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
RouteMatrixAsyncOptimizeRouteEnum	Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "più veloce" che restituisce il percorso per ridurre al minimo il tempo di viaggio. Esempio: "optimizeRoute":"shortest"
RouteMatrixAsyncRequest	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 destinazione. `GeoJSON` oggetto funzionalità e proprietà aggiuntive. Per informazioni dettagliate, vedere RFC 7946.
RouteMatrixAvoidEnum	Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.
RouteMatrixTrafficEnum	Specifica il modo in cui viene considerato il traffico per le route di calcolo. Valore predefinito: `historical`
RouteMatrixTravelModeEnum	Specifica il profilo di viaggio da considerare durante il calcolo della matrice. Se non specificato, il valore predefinito è "driving". Esempio: "travelMode":"driving"
RouteMatrixTypeEnum	Specifica il tipo MultiPoint di origine e il tipo MultiPoint di destinazione per la matrice di input.
RouteMatrixVehicleSpec	Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo della matrice di itinerario. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, curve a destra difficili per fornire il percorso ottimizzato in base alle specifiche del veicolo. Gli attributi del veicolo vengono specificati all'interno della proprietà vehicleSpec.
VehicleLoadTypeEnum	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. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.

AdrTunnelRestrictionCodeEnum

Enumerazione

Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.

Valore	Descrizione
B	I veicoli con codice B sono limitati dalle strade con categorie di tunnel ADR B, C, D ed E.
C	I veicoli con codice C sono limitati dalle strade con categorie di tunnel ADR C, D ed E
D	I veicoli con codice D sono limitati dalle strade con categorie di tunnel ADR D ed E.
E	I veicoli con codice E sono limitati dalle strade con categoria tunnel ADR E.

FeaturesItemTypeEnum

Enumerazione

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

Valore	Descrizione
Feature	Specifica il tipo di oggetto Feature `GeoJSON`.

FeatureTypeEnum

Enumerazione

Specifica il tipo di GeoJSON. L'unico tipo di oggetto supportato è FeatureCollection. Per altre informazioni, vedere RFC 7946.

Valore	Descrizione
FeatureCollection	Specifica il tipo di oggetto `GeoJSONFeatureCollection`.

GeoJsonMultiPoint

Object

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

Nome	Tipo	Descrizione
coordinates	number[] (double)	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.

InputRouteMatrixFeaturesItem

Object

Specifica l'origine di input e i punti di destinazione e le proprietà aggiuntive per l'oggetto funzionalità multipoint GeoJSON. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
geometry	GeoJsonMultiPoint	Tipo geometry `GeoJSON MultiPoint` valido. Per informazioni dettagliate, vedere RFC 7946.
properties	InputRouteMatrixProperties	Oggetto proprietà delle funzionalità multiPoint che specifica le funzionalità di origine e di destinazione per la matrice di input.
type	FeaturesItemTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

InputRouteMatrixProperties

Object

Specifica l'oggetto proprietà per la matrice di input.

Nome	Tipo	Descrizione
pointType	RouteMatrixTypeEnum	Specifica il tipo MultiPoint di origine e il tipo MultiPoint di destinazione per la matrice di input.

MapsErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	MapsErrorDetail[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	MapsInnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

MapsErrorResponse

Object

Risposta di errore comune per le API di Mappe di Azure per restituire i dettagli dell'errore per le operazioni non riuscite.

Nome	Tipo	Descrizione
error	MapsErrorDetail	Dettagli dell'errore.

MapsInnerError

Object

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	MapsInnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

RouteMatrixAsyncOptimizeRouteEnum

Enumerazione

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "più veloce" che restituisce il percorso per ridurre al minimo il tempo di viaggio.

Esempio: "optimizeRoute":"shortest"

Valore	Descrizione
fastest	Trova il percorso più veloce per ottimizzare l'itinerario in base al tempo di viaggio.
shortest	Trova il percorso più breve per ottimizzare l'itinerario in base alla distanza di viaggio.

RouteMatrixAsyncRequest

Object

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 destinazione. GeoJSON oggetto funzionalità e proprietà aggiuntive. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Valore predefinito	Descrizione
arriveAt	string		Data e ora di arrivo nel punto di destinazione formattato come valore `dateTime` definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC. Il parametro `arriveAt` non può essere utilizzato insieme a `departAt`. Il `arriveAt` supporta anche `any` valore personalizzato per il caso d'uso in cui il contesto temporale è irrilevante. Il valore del parametro `traffic=live` non può essere usato insieme a `any`. Valore predefinito: `any` se `arriveAt` non è specificato. Esempio: "arriveAt": "2024-12-01T09:30:00.000-07:00"
avoid	RouteMatrixAvoidEnum[]		Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.
departAt	string		Data e ora di partenza dal punto di origine formattato come valore `dateTime` definito da RFC 3339, sezione 5.6. Quando non viene specificata una differenza di fuso orario, si presuppone l'ora UTC. Il parametro `departAt` non può essere utilizzato insieme a `arriveAt`. Il `departAt` supporta anche: `any` valore personalizzato per il caso d'uso in cui il contesto temporale è irrilevante. Il valore del parametro `traffic=live` non può essere usato insieme a `any`. `now` valore per impostare l'ora di partenza sul tempo di elaborazione di ogni singola cella. Il tempo di elaborazione può essere in qualsiasi momento tra l'invio e il completamento. Questa modalità viene usata meglio insieme a traffic=live. Valore predefinito: `any` se `departAt` non è specificato. Esempio: "departAt": "2024-12-01T09:30:00.000-07:00"
features	InputRouteMatrixFeaturesItem[]		Set di punti di origine e di destinazione passati come funzionalità MultiPoint GeoJSON per la matrice di input. Per informazioni dettagliate sul formato GeoJSON, vedere RFC 7946.
optimizeRoute	RouteMatrixAsyncOptimizeRouteEnum	fastest	Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "più veloce" che restituisce il percorso per ridurre al minimo il tempo di viaggio. Esempio: "optimizeRoute":"shortest"
traffic	RouteMatrixTrafficEnum	historical	Specifica il modo in cui viene considerato il traffico per le route di calcolo. Valore predefinito: `historical`
travelMode	RouteMatrixTravelModeEnum	driving	Specifica il profilo di viaggio da considerare durante il calcolo della matrice. Se non specificato, il valore predefinito è "driving". Esempio: "travelMode":"driving"
type	FeatureTypeEnum		Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è `FeatureCollection`. Per altre informazioni, vedere RFC 7946.
vehicleSpec	RouteMatrixVehicleSpec		Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo della matrice di itinerario. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, curve a destra difficili per fornire il percorso ottimizzato in base alle specifiche del veicolo. Gli attributi del veicolo vengono specificati all'interno della proprietà vehicleSpec.

RouteMatrixAvoidEnum

Enumerazione

Specifica le restrizioni che il calcolo della route deve rispettare quando si determina la route. Evitare supporta più valori in una richiesta ed è supportato solo per la guida e il camion travelMode.

Valore	Descrizione
tollRoads	Evita l'uso di strade a pedaggio nel percorso.
unpavedRoads	Evita strade non pavimentate nel percorso.

RouteMatrixTrafficEnum

Enumerazione

Specifica il modo in cui viene considerato il traffico per le route di calcolo.

Valore predefinito: historical

Valore Descrizione

historical

Valore	Descrizione
historical	Il calcolo delle route considera i tempi di viaggio cronologici e le chiusura a lungo termine. Gli ingorghi del traffico e le chiusura a breve termine durante l'intervallo di tempo di viaggio non influiscono sul percorso o sul tempo di viaggio.
live	Oltre ai tempi di viaggio cronologici, il calcolo delle route considera gli ingorghi del traffico e le chiuse a breve e lungo termine durante l'intervallo di tempo di viaggio. `Note`: `traffic=live` non possono essere usate in combinazione con `arriveAt=any` e `departAt=any`

Il calcolo delle route considera i tempi di viaggio cronologici e le chiusura a lungo termine. Gli ingorghi del traffico e le chiusura a breve termine durante l'intervallo di tempo di viaggio non influiscono sul percorso o sul tempo di viaggio.

live

Oltre ai tempi di viaggio cronologici, il calcolo delle route considera gli ingorghi del traffico e le chiuse a breve e lungo termine durante l'intervallo di tempo di viaggio.

Note: traffic=live non possono essere usate in combinazione con arriveAt=any e departAt=any

RouteMatrixTravelModeEnum

Enumerazione

Specifica il profilo di viaggio da considerare durante il calcolo della matrice. Se non specificato, il valore predefinito è "driving".

Esempio: "travelMode":"driving"

Valore	Descrizione
driving	Il profilo di routing adatto alle automobili viene usato per il calcolo della matrice di route.
truck	Il profilo di routing adatto per veicoli commerciali come i camion vengono usati per il calcolo della matrice di itinerari.
walking	I percorsi restituiti sono ottimizzati per i pedoni, incluso l'uso di marciapiedi.

RouteMatrixTypeEnum

Enumerazione

Specifica il tipo MultiPoint di origine e il tipo MultiPoint di destinazione per la matrice di input.

Valore	Descrizione
destinations	Funzionalità multiPoint che definiscono le posizioni di destinazione nella matrice di input.
origins	Funzionalità multiPoint che definiscono le posizioni di origine nella matrice di input.

RouteMatrixVehicleSpec

Object

Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo della matrice di itinerario. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, curve a destra difficili per fornire il percorso ottimizzato in base alle specifiche del veicolo. Gli attributi del veicolo vengono specificati all'interno della proprietà vehicleSpec.

Nome	Tipo	Valore predefinito	Descrizione
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		Codice di restrizione del tunnel ADR. L'ADR è un accordo europeo relativo al trasporto internazionale di merci pericolose per strada. Il codice di restrizione del tunnel ADR viene utilizzato per determinare se un veicolo può attraversare un tunnel con restrizioni sul trasporto di merci pericolose.
axleWeight	integer (int64) minimum: 0 maximum: 1000000	0	Peso per asse del veicolo in kg. Il valore 0 indica che le restrizioni di peso per asse non vengono considerate.
height	number (double) minimum: 0 maximum: 1000000	0	Altezza del veicolo in metri. Il valore 0 indica che le restrizioni di altezza non vengono considerate.
isVehicleCommercial	boolean	False	Indica se il veicolo viene utilizzato per scopi commerciali. I veicoli commerciali potrebbero non essere autorizzati a guidare su alcune strade.
length	number (double) minimum: 0 maximum: 1000000	0	Lunghezza del veicolo in metri. Il valore 0 indica che le restrizioni di lunghezza non vengono considerate.
loadType	VehicleLoadTypeEnum[]		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. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.
maxSpeed	integer (int64) minimum: 0 maximum: 250	0	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.
weight	integer (int64) minimum: 0 maximum: 1000000	0	Peso del veicolo in kg. Il valore 0 indica che le restrizioni di peso non vengono considerate.
width	number (double) minimum: 0 maximum: 1000000	0	Larghezza del veicolo in metri. Il valore 0 indica che le restrizioni di larghezza non vengono considerate.

VehicleLoadTypeEnum

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. I valori che iniziano con USHazmat sono per l'instradamento degli Stati Uniti, mentre altrihazmat devono essere usati per tutti gli altri paesi. vehicleLoadType supporta più valori in una richiesta.

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

Condividi tramite

Route - Post Route Matrix Async

Invia richiesta matrice di route asincrona

Limitazioni api

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

AADToken

Ambiti

subscription-key

SAS Token

Esempio

Submit an asynchronous request for matrix

Esempio di richiesta

Risposta di esempio

Definizioni

AdrTunnelRestrictionCodeEnum

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonMultiPoint

InputRouteMatrixFeaturesItem

InputRouteMatrixProperties

MapsErrorDetail

MapsErrorResponse

MapsInnerError

RouteMatrixAsyncOptimizeRouteEnum

RouteMatrixAsyncRequest

RouteMatrixAvoidEnum

RouteMatrixTrafficEnum

RouteMatrixTravelModeEnum

RouteMatrixTypeEnum

RouteMatrixVehicleSpec

VehicleLoadTypeEnum