Route - Post Route Range

Servizio:: Maps

Versione API:: 2025-01-01

L'API Intervallo di route crea un poligono che illustra l'area raggiungibile da una determinata posizione entro una determinata soglia in base al budget di 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 il filtro spaziale per cercare le caratteristiche di interesse all'interno dell'isocrona fornito.

Per informazioni sulla disponibilità di routing in paesi/regioni, vedi Mappe di Azure routing coverage.

POST {endpoint}/route/range?api-version=2025-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Media Types: "application/geo+json"

Nome	Necessario	Tipo	Descrizione
x-ms-client-id		string	Indica l'account destinato all'uso con il modello di sicurezza Microsoft Entra ID. Questo ID univoco per l'account Mappe di Azure può essere ottenuto dall'Account API Mappe di Azure piano di gestione. Per maggiori informazioni sull'uso della sicurezza Microsoft Entra ID in Mappe di Azure, vedi Gestire l'autenticazione in Mappe di Azure.

Corpo della richiesta

Media Types: "application/geo+json"

Nome	Necessario	Tipo	Descrizione
geometry	True	RouteRangePointGeometry	Specifica l'oggetto Geometry punto `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
properties	True	InputRouteRangeProperties	Specifica i parametri da utilizzare per il calcolo del poligono isocrona.
type	True	FeaturesItemTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

Risposte

Nome	Tipo	Descrizione
200 OK	RouteRangeResponse	La richiesta ha avuto esito positivo. Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Risposta di errore imprevista. Media Types: "application/geo+json", "application/json"

Nome

Tipo

Descrizione

200 OK

RouteRangeResponse

La richiesta ha avuto esito positivo.

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Risposta di errore imprevista.

Media Types: "application/geo+json", "application/json"

Sicurezza

AadToken

Questi sono i flussi Microsoft Entra OAuth 2.0. Quando abbinata al controllo Azure basato su ruolo può essere utilizzata per controllare l'accesso alle API REST di Mappe di Azure. I controlli di accesso basati su ruoli di Azure sono utilizzati per designare l'accesso a uno o più account o sottorisorse risorse di Mappe di Azure. Qualsiasi utente, gruppo o principale di servizio può ricevere l'accesso tramite un ruolo integrato o un ruolo personalizzato composto da uno o più permessi per Mappe di Azure API REST.\n\nPer implementare scenari, consigliamo di consultare i concetti di autenticazione . In sintesi, questa definizione di sicurezza fornisce una soluzione per modellare l'applicazione tramite oggetti in grado di controllo degli accessi su API e ambiti specifici.\n\n#### Note\n* Questa definizione di sicurezza richiede l'uso dell'intestazione x-ms-client-id per indicare a quale Mappe di Azure risorsa l'applicazione richiede accesso. Questo può essere acquisito dall'API di gestione Maps.\n* \nIl Authorization URL è specifico per l'istanza Azure cloud pubblico. I cloud sovrani hanno URL di autorizzazione unici e configurazioni Microsoft Entra ID. \n* \nIl controllo accessibile basato sul ruolo Azure viene configurato dal piano di gestione Azure tramite Azure portale, PowerShell, CLI, Azure SDK o API REST.\n* \nUtilizzo del Mappe di Azure Web SDK consente la configurazione di un'applicazione basata sulla configurazione per molteplici casi d'uso.\n* Per maggiori informazioni su Microsoft Identity Platform, vedi Microsoft Identity Platform panoramica.

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

Ambiti

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

subscription-key

Questa è una chiave condivisa che viene fornita quando Crea un account Mappe di Azure nel portale Azure o utilizzando PowerShell, CLI, Azure SDK o API REST.\n\n Con questa chiave, qualsiasi applicazione può accedere a tutte le API REST. In altre parole, questa chiave può essere utilizzata come chiave master nell'account in cui vengono rilasciate.\n\n Per applicazioni pubblicamente esposte, la nostra raccomandazione è di utilizzare l'approccio confidential per accedere alle API REST Mappe di Azure modo che la tua chiave possa essere memorizzata in modo sicuro.

Tipo: apiKey
In: header

SAS Token

Questo token di firma di accesso condiviso viene creato dall'operazione List SAS sulla risorsa Mappe di Azure tramite il piano di gestione Azure tramite portale Azure, PowerShell, CLI, Azure SDK o API REST.\n\n Con questo token, qualsiasi applicazione è autorizzata ad accedere con Azure Controlli di accesso basati su ruoli e controllo sottile sulla scadenza, la velocità e la regione/i di utilizzo per il token specifico. In altre parole, il Token SAS può essere utilizzato per permettere alle applicazioni di controllare l'accesso in modo più sicuro rispetto alla chiave condivisa.\n\n Per applicazioni pubblicamente esposte, la nostra raccomandazione è di configurare una lista specifica di origini consentite sulla risorsa dell'account Map per limitare l'abuso di rendering e rinnovare regolarmente il token SAS.

Tipo: apiKey
In: header

Esempio

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

Esempio di richiesta

HTTP

POST {endpoint}/route/range?api-version=2025-01-01

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      5.86605,
      50.9745
    ]
  },
  "properties": {
    "timeBudgetInSec": 6000
  }
}

Risposta di esempio

Codice di stato:: 200

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

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.
GeoJsonObjectType	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.
InputRouteRangeProperties	Specifica i parametri da utilizzare per il calcolo del poligono isocrona.
MapsErrorDetail	Dettagli dell'errore.
MapsErrorResponse	Risposta comune all'errore per le API di Mappe di Azure per restituire dettagli di errore per operazioni fallite.
MapsInnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
RouteRangeAvoidEnum	Specifica le restrizioni che il calcolo della route deve rispettare quando si determinano le posizioni raggiungibili. Evitare di supportare più valori in una richiesta. \n\nEsempio: "evitare": ["autostrade ad accesso limitato", "autostrade a pedaggio"]
RouteRangeFeatureProperties	Proprietà degli intervalli di route.
RouteRangeFeaturesItem	Oggetto funzionalità GeoJSON che contiene l'oggetto Geometry e proprietà aggiuntive della route.
RouteRangeOptimizeRouteEnum	Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti. Esempio: "optimizeRoute":"shortest"
RouteRangePointGeometry	Specifica l'oggetto Geometry punto `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
RouteRangePolygonGeometry	Specifica l'oggetto Geometry polygon `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
RouteRangeRequest	Specifica il punto iniziale per il calcolo dell'intervallo. `GeoJSON` oggetto funzionalità e proprietà aggiuntive. Per informazioni dettagliate, vedere RFC 7946.
RouteRangeResponse	Questo oggetto viene restituito da una chiamata riuscita.
RouteRangeTravelModeEnum	Specifica il profilo di viaggio da considerare durante il calcolo del poligono di intervallo. Se non specificato, il valore predefinito è "driving". Esempio: "travelMode":"driving"
RouteRangeTypeEnum	Tipi di funzionalità per gli oggetti funzionalità restituiti nella risposta.
RouteRangeVehicleSpec	Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo delle posizioni raggiungibili. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion 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.

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`.

GeoJsonObjectType

Enumerazione

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.

Valore	Descrizione
Point	`GeoJSON Point` geometria.
MultiPoint	`GeoJSON MultiPoint` geometria.
LineString	`GeoJSON LineString` geometria.
MultiLineString	`GeoJSON MultiLineString` geometria.
Polygon	`GeoJSON Polygon` geometria.
MultiPolygon	`GeoJSON MultiPolygon` geometria.
GeometryCollection	`GeoJSON GeometryCollection` geometria.
Feature	Oggetto `GeoJSON Feature`.
FeatureCollection	Oggetto `GeoJSON FeatureCollection`.

InputRouteRangeProperties

Oggetto

Specifica i parametri da utilizzare per il calcolo del poligono isocrona.

Nome	Tipo	Valore predefinito	Descrizione
avoid	RouteRangeAvoidEnum[]		Specifica le restrizioni che il calcolo della route deve rispettare quando si determinano le posizioni raggiungibili. Evitare di supportare più valori in una richiesta. Esempio: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt	string (date-time)		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. Se il `departAt` non è impostato, il valore predefinito è l'ora corrente. Esempio: "departAt": "2023-06-01T09:30:00.000-07:00"
distanceBudgetInMeters	number (float) maximum: 500000		Il budget della distanza specifica l'intervallo massimo in metri che può essere viaggiato dal punto di partenza. Non può essere impostata quando viene specificato `timeBudgetInSec`. Quando `isSimplifiedPolygon` è false, la distanza massima supportata è di 90000 metri; in caso contrario, è di 500.000 metri. Esempio: "distanceBudgetInMeters":5000
isSimplifiedPolygon	boolean	True	Utilizzare questa opzione per specificare se sono necessari poligoni semplificati che riducono il numero di vertici poligoni mantenendo la forma. L'API restituisce il poligono a bassa definizione per impostazione predefinita.
optimizeRoute	RouteRangeOptimizeRouteEnum	fastestWithoutTraffic	Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti. Esempio: "optimizeRoute":"shortest"
timeBudgetInSec	number (float) maximum: 21600		Il budget temporale specifica il tempo massimo in secondi disponibili per il viaggio, definendo la distanza entro questo vincolo temporale dal punto di partenza. Non può essere impostata quando viene specificato `distanceBudgetInMeters`. Quando `isSimplifiedPolygon` è false, il tempo massimo supportato è 3600 secondi, altrimenti è 21.600 secondi. Esempio: "timeBudgetInSec":3600
travelMode	RouteRangeTravelModeEnum	driving	Specifica il profilo di viaggio da considerare durante il calcolo del poligono di intervallo. Se non specificato, il valore predefinito è "driving". Esempio: "travelMode":"driving"
vehicleSpec	RouteRangeVehicleSpec		Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo delle posizioni raggiungibili. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion in base alle specifiche del veicolo. Gli attributi del veicolo vengono specificati all'interno della proprietà vehicleSpec.

MapsErrorDetail

Oggetto

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

Oggetto

Risposta comune all'errore per le API di Mappe di Azure per restituire dettagli di errore per operazioni fallite.

Nome	Tipo	Descrizione
error	MapsErrorDetail	Dettagli dell'errore.

MapsInnerError

Oggetto

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.

RouteRangeAvoidEnum

Enumerazione

Specifica le restrizioni che il calcolo della route deve rispettare quando si determinano le posizioni raggiungibili. Evitare di supportare più valori in una richiesta. \n\nEsempio: "evitare": ["autostrade ad accesso limitato", "autostrade a pedaggio"]

Valore	Descrizione
limitedAccessHighways	Evita l'uso di autostrade ad accesso limitato nel percorso.
tollRoads	Evita l'uso di strade a pedaggio nel percorso.
ferries	Evita l'uso di traghetti nel percorso.
tunnels	Evita l'uso di tunnel nella route.
borderCrossings	Evita di attraversare i confini del paese nel percorso.
lowEmissionZones	Evita zone a basse emissioni nel percorso.
unpavedRoads	Evita strade non pavimentate nel percorso.
carpools	Evita itinerari che richiedono l'uso di carpooling.
carTrains	Evita treni auto.

RouteRangeFeatureProperties

Oggetto

Proprietà degli intervalli di route.

Nome	Tipo	Descrizione
type	RouteRangeTypeEnum	Tipi di funzionalità per gli oggetti funzionalità restituiti nella risposta.

RouteRangeFeaturesItem

Oggetto

Oggetto funzionalità GeoJSON che contiene l'oggetto Geometry e proprietà aggiuntive della route.

Nome	Tipo	Descrizione
bbox	number[] (double)	Area rettangolare sulla terra definita come oggetto rettangolo delimitatore. I lati dei rettangoli sono definiti dai valori di latitudine e longitudine. Per altre informazioni, vedere RFC 7946, sezione 5. Esempio: "bbox": [-10.0, -10.0, 10.0, 10.0]
geometry	RouteRangeGeometry: RouteRangePointGeometry RouteRangePolygonGeometry	Oggetto Geometry valido `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
properties	RouteRangeFeatureProperties	Proprietà degli intervalli di route.
type	FeaturesItemTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

RouteRangeOptimizeRouteEnum

Enumerazione

Specifica il parametro da usare per ottimizzare la route. Se non definito, il valore predefinito è "fastestWithoutTraffic" che restituisce il percorso per ridurre al minimo il tempo di viaggio senza usare le informazioni sul traffico correnti.

Esempio: "optimizeRoute":"shortest"

Valore	Descrizione
shortest	Il percorso viene calcolato per ridurre al minimo la distanza. Le informazioni sul traffico non vengono usate.
fastestWithoutTraffic	Trova la route più veloce, senza considerare le informazioni sul traffico.
fastestWithTraffic	La route viene calcolata per ridurre al minimo il tempo usando le informazioni sul traffico correnti. `Note`: supportato solo per la guida e il trasporto di camionMode.

RouteRangePointGeometry

Oggetto

Specifica l'oggetto Geometry punto GeoJSON. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Un `Position` è una matrice di numeri con due o più elementi. I primi due elementi sono longitudine e latitudine, esattamente in tale ordine. altitudine/elevazione è un terzo elemento facoltativo. Per informazioni dettagliate, vedere RFC 7946.
type	string: Point	Specifica il tipo di geometria per l'oggetto Geometry `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.

RouteRangePolygonGeometry

Oggetto

Specifica l'oggetto Geometry polygon GeoJSON. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
coordinates	number[] (double)	Coordinate per il tipo di geometria `GeoJson Polygon`.
type	string: Polygon	Specifica il tipo di geometria per l'oggetto Geometry `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.

RouteRangeRequest

Oggetto

Specifica il punto iniziale per il calcolo dell'intervallo. GeoJSON oggetto funzionalità e proprietà aggiuntive. Per informazioni dettagliate, vedere RFC 7946.

Nome	Tipo	Descrizione
geometry	RouteRangePointGeometry	Specifica l'oggetto Geometry punto `GeoJSON`. Per informazioni dettagliate, vedere RFC 7946.
properties	InputRouteRangeProperties	Specifica i parametri da utilizzare per il calcolo del poligono isocrona.
type	FeaturesItemTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è Feature. Per altre informazioni, vedere RFC 7946.

RouteRangeResponse

Oggetto

Questo oggetto viene restituito da una chiamata riuscita.

Nome	Tipo	Descrizione
features	RouteRangeFeaturesItem[]	`GeoJSON` oggetto feature che contiene l'oggetto Geometry e le proprietà aggiuntive. Per informazioni dettagliate, vedere RFC 7946, Sezione 3.2.
type	FeatureTypeEnum	Specifica il tipo di `GeoJSON`. L'unico tipo di oggetto supportato è `FeatureCollection`. Per altre informazioni, vedere RFC 7946.

RouteRangeTravelModeEnum

Enumerazione

Specifica il profilo di viaggio da considerare durante il calcolo del poligono di intervallo. Se non specificato, il valore predefinito è "driving".

Esempio: "travelMode":"driving"

Valore	Descrizione
driving	Il profilo di routing adatto per le automobili viene usato per il calcolo poligono di intervallo.
truck	Il profilo di routing adatto per veicoli commerciali come i camion viene usato per il calcolo del poligono di intervallo.

RouteRangeTypeEnum

Enumerazione

Tipi di funzionalità per gli oggetti funzionalità restituiti nella risposta.

Valore	Descrizione
center	Il tipo di caratteristica punto centrale rappresenta il punto utilizzato per il calcolo del poligono di intervallo.
boundary	Il tipo di funzionalità limite rappresenta il poligono dell'intervallo.

RouteRangeVehicleSpec

Oggetto

Specifica gli attributi del veicolo, ad esempio altezza del veicolo, peso, velocità massima, tipo di carico e così via, da considerare durante il calcolo delle posizioni raggiungibili. Ciò consente di evitare spazi di ponte bassi, restrizioni stradali, turni di destra difficili per fornire il percorso ottimizzato dei camion 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.
axleCount	integer (int64)		Numero di assi sul veicolo.
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.

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

Condividi tramite

Route - Post Route Range

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

AadToken

Ambiti

subscription-key

SAS Token

Esempio

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

Esempio di richiesta

Risposta di esempio

Definizioni

AdrTunnelRestrictionCodeEnum

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonObjectType

InputRouteRangeProperties

MapsErrorDetail

MapsErrorResponse

MapsInnerError

RouteRangeAvoidEnum

RouteRangeFeatureProperties

RouteRangeFeaturesItem

RouteRangeOptimizeRouteEnum

RouteRangePointGeometry

RouteRangePolygonGeometry

RouteRangeRequest

RouteRangeResponse

RouteRangeTravelModeEnum

RouteRangeTypeEnum

RouteRangeVehicleSpec

VehicleLoadTypeEnum