Partager via


Route - Post Route Range

L’API Plage de routes crée un polygone qui représente la zone accessible à partir d’un emplacement donné dans un certain seuil en fonction du budget de temps ou de distance spécifié. Une limite de polygone (ou Isochrone) est retournée dans une orientation au sens inverse ainsi que le centre de polygones précis qui a été le résultat du point d’origine.

Le polygone retourné peut être utilisé pour le filtrage spatial pour rechercher des caractéristiques intéressantes dans l’Isochrone fourni.

Pour plus d’informations sur la disponibilité du routage dans les pays/régions, consultez couverture du routage Azure Maps.

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

Paramètres URI

Nom Dans Obligatoire Type Description
api-version
query True

string

Numéro de version de l’API Azure Maps.

En-tête de la demande

Media Types: "application/geo+json"

Nom Obligatoire Type Description
x-ms-client-id

string

Indique le compte destiné à être utilisé avec le modèle de sécurité Microsoft Entra ID. Cet ID unique pour le compte Azure Maps peut être obtenu à partir de l’API de compte du plan de gestion Azure Maps. Pour plus d’informations sur l’utilisation de la sécurité Microsoft Entra ID dans Azure Maps, consultez Gérer l’authentification dans Azure Maps.

Corps de la demande

Media Types: "application/geo+json"

Nom Obligatoire Type Description
geometry True

RouteRangePointGeometry

Spécifie l’objet GeoJSON Point Geometry. Pour plus d’informations, reportez-vous à RFC 7946.

properties True

InputRouteRangeProperties

Spécifie les paramètres à utiliser pour le calcul du polygone isochrone.

type True

FeaturesItemTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est Feature. Pour plus d’informations, consultez RFC 7946.

Réponses

Nom Type Description
200 OK

RouteRangeResponse

D’ACCORD

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

Other Status Codes

MapsErrorResponse

Une erreur inattendue s’est produite.

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

En-têtes

x-ms-error-code: string

Sécurité

AADToken

Il s’agit des flux Microsoft Entra OAuth 2.0. Lorsqu’il est associé à 'accès en fonction du rôle Azure contrôle, il peut être utilisé pour contrôler l’accès aux API REST Azure Maps. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes de ressources Azure Maps ou sous-ressources. Tout utilisateur, groupe ou principal de service peut avoir accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations pour les API REST Azure Maps.

Pour implémenter des scénarios, nous vous recommandons d’afficher concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour la modélisation des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.

Remarque

  • Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer la ressource Azure Maps à laquelle l’application demande l’accès. Cela peut être acquis à partir de l’API de gestion Maps.
  • La Authorization URL est spécifique à l’instance de cloud public Azure. Les clouds souverains ont des URL d’autorisation uniques et des configurations d’ID Microsoft Entra.
  • Le contrôle d’accès en fonction du rôle Azure est configuré à partir de l'plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST.
  • L’utilisation du kit de développement logiciel (SDK) web Azure Maps permet la configuration basée sur la configuration d’une application pour plusieurs cas d’usage.
  • Pour plus d’informations sur la plateforme d’identités Microsoft, consultez vue d’ensemble de la plateforme d’identités Microsoft.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Il s’agit d’une clé partagée provisionnée lors de la création d’une ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, CLI, kits SDK Azure ou API REST.

Avec cette clé, toute application est autorisée à accéder à toutes les API REST. En d’autres termes, ces clés peuvent être traitées comme des clés principales pour le compte pour lequel elles sont émises.

Pour les applications exposées publiquement, nous vous recommandons d’utiliser l’accès serveur à serveur des API REST Azure Maps où cette clé peut être stockée en toute sécurité.

Type: apiKey
Dans: header

SAS Token

Il s’agit d’un jeton de signature d’accès partagé créé à partir de l’opération List SAS sur la ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, CLI, azure SDK ou LES API REST.

Avec ce jeton, toute application est autorisée à accéder avec des contrôles d’accès en fonction du rôle Azure et un contrôle précis à l’expiration, au taux et aux régions d’utilisation pour le jeton particulier. En d’autres termes, le jeton SAP peut être utilisé pour permettre aux applications de contrôler l’accès de manière plus sécurisée que la clé partagée.

Pour les applications exposées publiquement, nous vous recommandons de configurer une liste spécifique d’origines autorisées sur la ressource de compte mapper pour limiter l’abus de rendu et renouveler régulièrement le jeton SAP.

Type: apiKey
Dans: header

Exemples

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

Exemple de requête

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

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

Exemple de réponse

{
  "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"
      }
    }
  ]
}

Définitions

Nom Description
AdrTunnelRestrictionCodeEnum

Code de restriction du tunnel ADR. L’ADR est un accord européen concernant le transport international de marchandises dangereuses par route. Le code de restriction du tunnel ADR est utilisé pour déterminer si un véhicule est autorisé à traverser un tunnel avec des restrictions sur le transport de marchandises dangereuses.

FeaturesItemTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est Feature. Pour plus d’informations, consultez RFC 7946.

FeatureTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est FeatureCollection. Pour plus d’informations, consultez RFC 7946.

InputRouteRangeProperties

Spécifie les paramètres à utiliser pour le calcul du polygone isochrone.

MapsErrorDetail

Détail de l’erreur.

MapsErrorResponse

Réponse d’erreur courante pour les API Azure Maps pour retourner les détails d’erreur pour les opérations ayant échoué.

MapsInnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

RouteRangeAvoidEnum

Spécifie les restrictions que le calcul de l’itinéraire doit respecter lors de la détermination des emplacements accessibles. Évitez de prendre en charge plusieurs valeurs dans une requête.

Exemple : « avoid » : ["limitedAccessHighways », « tollRoads"]

RouteRangeFeatureProperties

Propriétés des plages d’itinéraires.

RouteRangeFeaturesItem

Objet de fonctionnalité GeoJSON qui contient l’objet Geometry et les propriétés supplémentaires de l’itinéraire.

RouteRangeOptimizeRouteEnum

Spécifie le paramètre à utiliser pour optimiser l’itinéraire. S’il n’est pas défini, la valeur par défaut est « fastestWithoutTraffic » qui retourne l’itinéraire pour réduire le temps de trajet sans utiliser les informations de trafic actuelles.

Exemple : « optimizeRoute » : « shortest »

RouteRangePointGeometry

Spécifie l’objet GeoJSON Point Geometry. Pour plus d’informations, reportez-vous à RFC 7946.

RouteRangePolygonGeometry

Spécifie l’objet geometry de polygone GeoJSON. Pour plus d’informations, reportez-vous à RFC 7946.

RouteRangeRequest

Spécifie le point de départ du calcul de plage. GeoJSON objet de fonctionnalité et des propriétés supplémentaires. Pour plus d’informations, reportez-vous à RFC 7946.

RouteRangeResponse

Cet objet est retourné à partir d’un appel réussi.

RouteRangeTravelModeEnum

Spécifie le profil de déplacement à prendre en compte lors du calcul du polygone de plage. Si elle n’est pas spécifiée, la valeur par défaut est « driving ».

Exemple : " travelMode » :"driving »

RouteRangeTypeEnum

Types de fonctionnalités pour les objets de fonctionnalité retournés dans la réponse.

RouteRangeVehicleSpec

Spécifie les attributs du véhicule tels que la hauteur, le poids, la vitesse maximale, le type de cargaison, etc. à prendre en compte lors du calcul des emplacements accessibles. Cela permet d’éviter les dégagements de pont faibles, les restrictions routières, les virages de droite difficiles pour fournir l’itinéraire optimisé des camions en fonction des spécifications du véhicule. Les attributs de véhicule sont spécifiés dans la propriété vehicleSpec.

VehicleLoadTypeEnum

Types de cargaisons pouvant être classifiées comme matières dangereuses et restreintes à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes hazmat américaines 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays. Les valeurs commençant par USHazmat sont destinées au routage américain, tandis que d’autresHazmat doivent être utilisées pour tous les autres pays. vehicleLoadType prend en charge plusieurs valeurs dans une requête.

AdrTunnelRestrictionCodeEnum

Code de restriction du tunnel ADR. L’ADR est un accord européen concernant le transport international de marchandises dangereuses par route. Le code de restriction du tunnel ADR est utilisé pour déterminer si un véhicule est autorisé à traverser un tunnel avec des restrictions sur le transport de marchandises dangereuses.

Valeur Description
B

Les véhicules avec le code B sont limités aux routes avec les catégories de tunnel ADR B, C, D et E.

C

Les véhicules avec le code C sont limités aux routes avec les catégories de tunnel ADR C, D et E

D

Les véhicules avec le code D sont limités aux routes avec les catégories de tunnel ADR D et E.

E

Les véhicules avec le code E sont limités aux routes avec la catégorie de tunnel ADR E.

FeaturesItemTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est Feature. Pour plus d’informations, consultez RFC 7946.

Valeur Description
Feature

Spécifie le type d’objet Feature GeoJSON.

FeatureTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est FeatureCollection. Pour plus d’informations, consultez RFC 7946.

Valeur Description
FeatureCollection

Spécifie le type d’objet GeoJSONFeatureCollection.

InputRouteRangeProperties

Spécifie les paramètres à utiliser pour le calcul du polygone isochrone.

Nom Type Valeur par défaut Description
avoid

RouteRangeAvoidEnum[]

Spécifie les restrictions que le calcul de l’itinéraire doit respecter lors de la détermination des emplacements accessibles. Évitez de prendre en charge plusieurs valeurs dans une requête.

Exemple : « avoid » : ["limitedAccessHighways », « tollRoads"]

departAt

string (date-time)

Date et heure de départ du point d’origine mis en forme comme valeur dateTime définie par RFC 3339, section 5.6. Lorsqu’un décalage de fuseau horaire n’est pas spécifié, l’heure UTC est supposée.

Si le departAt n’est pas défini, la valeur par défaut est l’heure actuelle.

Exemple:

« departAt » : « 2023-06-01T09:30:00.000-07:00 »

distanceBudgetInMeters

number (float)

minimum: 0
maximum: 500000

Le budget de distance spécifie la plage maximale en mètres qui peut être parcourue à partir du point de route d’origine. Il ne peut pas être défini lorsque timeBudgetInSec est spécifié.

Lorsque isSimplifiedPolygon est false, la distance maximale prise en charge est de 90000 mètres, sinon elle est de 500 000 mètres.

Exemple : « distanceBudgetInMeters » :5000

isSimplifiedPolygon

boolean

True

Utilisez cette option pour spécifier si vous avez besoin de polygones simplifiés qui réduisent le nombre de sommets de polygones tout en préservant la forme. L’API retourne un polygone de faible définition par défaut.

optimizeRoute

RouteRangeOptimizeRouteEnum

fastestWithoutTraffic

Spécifie le paramètre à utiliser pour optimiser l’itinéraire. S’il n’est pas défini, la valeur par défaut est « fastestWithoutTraffic » qui retourne l’itinéraire pour réduire le temps de trajet sans utiliser les informations de trafic actuelles.

Exemple : « optimizeRoute » : « shortest »

timeBudgetInSec

number (float)

minimum: 0
maximum: 21600

Le budget de temps spécifie la durée maximale en secondes disponibles pour le voyage, en définissant la distance à laquelle l’on peut aller dans cette contrainte de temps à partir du point de route d’origine. Il ne peut pas être défini lorsque distanceBudgetInMeters est spécifié.

Lorsque isSimplifiedPolygon la valeur est false, la durée maximale prise en charge est de 3600 secondes, sinon elle est de 21 600 secondes.

Exemple : « timeBudgetInSec » :3600

travelMode

RouteRangeTravelModeEnum

driving

Spécifie le profil de déplacement à prendre en compte lors du calcul du polygone de plage. Si elle n’est pas spécifiée, la valeur par défaut est « driving ».

Exemple : " travelMode » :"driving »

vehicleSpec

RouteRangeVehicleSpec

Spécifie les attributs du véhicule tels que la hauteur, le poids, la vitesse maximale, le type de cargaison, etc. à prendre en compte lors du calcul des emplacements accessibles. Cela permet d’éviter les dégagements de pont faibles, les restrictions routières, les virages de droite difficiles pour fournir l’itinéraire optimisé des camions en fonction des spécifications du véhicule. Les attributs de véhicule sont spécifiés dans la propriété vehicleSpec.

MapsErrorDetail

Détail de l’erreur.

Nom Type Description
code

string

Un ensemble de codes d’erreur définis par le serveur.

details

MapsErrorDetail[]

Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.

innererror

MapsInnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

message

string

Représentation lisible par l’homme de l’erreur.

target

string

Cible de l’erreur.

MapsErrorResponse

Réponse d’erreur courante pour les API Azure Maps pour retourner les détails d’erreur pour les opérations ayant échoué.

Nom Type Description
error

MapsErrorDetail

Détail de l’erreur.

MapsInnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

Nom Type Description
code

string

Code d’erreur.

innererror

MapsInnerError

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

RouteRangeAvoidEnum

Spécifie les restrictions que le calcul de l’itinéraire doit respecter lors de la détermination des emplacements accessibles. Évitez de prendre en charge plusieurs valeurs dans une requête.

Exemple : « avoid » : ["limitedAccessHighways », « tollRoads"]

Valeur Description
limitedAccessHighways

Évite l’utilisation d’autoroutes à accès limité dans l’itinéraire.

tollRoads

Évite l’utilisation des routes de péage dans l’itinéraire.

ferries

Évite l’utilisation de ferrys en route.

tunnels

Évite l’utilisation de tunnels dans l’itinéraire.

borderCrossings

Évite de traverser les frontières du pays en route.

lowEmissionZones

Évite les zones à faible émission dans l’itinéraire.

unpavedRoads

Évite les routes non pavées dans l’itinéraire.

carpools

Évite les itinéraires qui nécessitent l’utilisation du pool de voitures.

carTrains

Évite les trains de voiture.

RouteRangeFeatureProperties

Propriétés des plages d’itinéraires.

Nom Type Description
type

RouteRangeTypeEnum

Types de fonctionnalités pour les objets de fonctionnalité retournés dans la réponse.

RouteRangeFeaturesItem

Objet de fonctionnalité GeoJSON qui contient l’objet Geometry et les propriétés supplémentaires de l’itinéraire.

Nom Type Description
bbox

number[] (double)

Une zone rectangulaire sur la terre définie comme un objet de cadre englobant. Les côtés des rectangles sont définis par les valeurs de latitude et de longitude. Pour plus d’informations, consultez RFC 7946, section 5.

Exemple : « bbox » : [-10.0, -10.0, 10.0, 10.0]

geometry RouteRangeGeometry:

Objet Geometry GeoJSON valide. Pour plus d’informations, reportez-vous à RFC 7946.

properties

RouteRangeFeatureProperties

Propriétés des plages d’itinéraires.

type

FeaturesItemTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est Feature. Pour plus d’informations, consultez RFC 7946.

RouteRangeOptimizeRouteEnum

Spécifie le paramètre à utiliser pour optimiser l’itinéraire. S’il n’est pas défini, la valeur par défaut est « fastestWithoutTraffic » qui retourne l’itinéraire pour réduire le temps de trajet sans utiliser les informations de trafic actuelles.

Exemple : « optimizeRoute » : « shortest »

Valeur Description
shortest

L’itinéraire est calculé pour réduire la distance. Les informations de trafic ne sont pas utilisées.

fastestWithoutTraffic

Trouve l’itinéraire le plus rapide, sans prendre en compte les informations de trafic.

fastestWithTraffic

L’itinéraire est calculé pour réduire le temps à l’aide des informations de trafic actuelles. Note: uniquement pris en charge pour la conduite et le camion travelMode.

RouteRangePointGeometry

Spécifie l’objet GeoJSON Point Geometry. Pour plus d’informations, reportez-vous à RFC 7946.

Nom Type Description
coordinates

number[] (double)

Un Position est un tableau de nombres avec deux éléments ou plus. Les deux premiers éléments sont longitude et latitude, précisément dans cet ordre. altitude/élévation est un troisième élément facultatif. Pour plus d’informations, reportez-vous à RFC 7946.

type string:

Point

Spécifie le type de géométrie de l’objet geometry GeoJSON. Pour plus d’informations, reportez-vous à RFC 7946.

RouteRangePolygonGeometry

Spécifie l’objet geometry de polygone GeoJSON. Pour plus d’informations, reportez-vous à RFC 7946.

Nom Type Description
coordinates

number[] (double)

Coordonnées pour le type de géométrie GeoJson Polygon.

type string:

Polygon

Spécifie le type de géométrie de l’objet geometry GeoJSON. Pour plus d’informations, reportez-vous à RFC 7946.

RouteRangeRequest

Spécifie le point de départ du calcul de plage. GeoJSON objet de fonctionnalité et des propriétés supplémentaires. Pour plus d’informations, reportez-vous à RFC 7946.

Nom Type Description
geometry

RouteRangePointGeometry

Spécifie l’objet GeoJSON Point Geometry. Pour plus d’informations, reportez-vous à RFC 7946.

properties

InputRouteRangeProperties

Spécifie les paramètres à utiliser pour le calcul du polygone isochrone.

type

FeaturesItemTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est Feature. Pour plus d’informations, consultez RFC 7946.

RouteRangeResponse

Cet objet est retourné à partir d’un appel réussi.

Nom Type Description
features

RouteRangeFeaturesItem[]

GeoJSON objet de fonctionnalité qui contient un objet Geometry et des propriétés supplémentaires. Pour plus d’informations, reportez-vous à RFC 7946, section 3.2.

type

FeatureTypeEnum

Spécifie le type GeoJSON. Le seul type d’objet pris en charge est FeatureCollection. Pour plus d’informations, consultez RFC 7946.

RouteRangeTravelModeEnum

Spécifie le profil de déplacement à prendre en compte lors du calcul du polygone de plage. Si elle n’est pas spécifiée, la valeur par défaut est « driving ».

Exemple : " travelMode » :"driving »

Valeur Description
driving

Le profil de routage adapté aux voitures est utilisé pour le calcul des polygones de plage.

truck

Le profil de routage adapté aux véhicules commerciaux comme les camions est utilisé pour le calcul des polygones de plage.

RouteRangeTypeEnum

Types de fonctionnalités pour les objets de fonctionnalité retournés dans la réponse.

Valeur Description
center

Le type de fonctionnalité de point central représente le point utilisé pour le calcul du polygone de plage.

boundary

Le type de fonctionnalité de limite représente le polygone de plage.

RouteRangeVehicleSpec

Spécifie les attributs du véhicule tels que la hauteur, le poids, la vitesse maximale, le type de cargaison, etc. à prendre en compte lors du calcul des emplacements accessibles. Cela permet d’éviter les dégagements de pont faibles, les restrictions routières, les virages de droite difficiles pour fournir l’itinéraire optimisé des camions en fonction des spécifications du véhicule. Les attributs de véhicule sont spécifiés dans la propriété vehicleSpec.

Nom Type Valeur par défaut Description
adrTunnelRestrictionCode

AdrTunnelRestrictionCodeEnum

Code de restriction du tunnel ADR. L’ADR est un accord européen concernant le transport international de marchandises dangereuses par route. Le code de restriction du tunnel ADR est utilisé pour déterminer si un véhicule est autorisé à traverser un tunnel avec des restrictions sur le transport de marchandises dangereuses.

axleCount

integer (int64)

Nombre d’axes sur le véhicule.

axleWeight

integer (int64)

minimum: 0
maximum: 1000000
0

Poids par axe du véhicule en kg. La valeur 0 signifie que les restrictions de poids par axe ne sont pas prises en compte.

height

number (double)

minimum: 0
maximum: 1000000
0

Hauteur du véhicule en mètres. La valeur 0 signifie que les restrictions de hauteur ne sont pas prises en compte.

isVehicleCommercial

boolean

False

Indique si le véhicule est utilisé à des fins commerciales. Les véhicules commerciaux peuvent ne pas être autorisés à conduire sur certaines routes.

length

number (double)

minimum: 0
maximum: 1000000
0

Longueur du véhicule en mètres. La valeur 0 signifie que les restrictions de longueur ne sont pas prises en compte.

loadType

VehicleLoadTypeEnum[]

Types de cargaisons pouvant être classifiées comme matières dangereuses et restreintes à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes hazmat américaines 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays. Les valeurs commençant par USHazmat sont destinées au routage américain, tandis que d’autresHazmat doivent être utilisées pour tous les autres pays. vehicleLoadType prend en charge plusieurs valeurs dans une requête.

maxSpeed

integer (int64)

minimum: 0
maximum: 250
0

Vitesse maximale du véhicule en km/heure. La vitesse maximale dans le profil du véhicule est utilisée pour vérifier si un véhicule est autorisé sur les autoroutes.

La valeur 0 signifie qu’une valeur appropriée pour le véhicule sera déterminée et appliquée pendant la planification de l’itinéraire.

Une valeur non nulle peut être remplacée pendant la planification de l’itinéraire. Par exemple, le flux de trafic actuel est de 60 km/heure. Si la vitesse maximale du véhicule est définie sur 50 km/heure, le moteur de routage prend en compte 60 km/heure, car il s’agit de la situation actuelle. Si la vitesse maximale du véhicule est fournie comme étant de 80 km/heure, mais que le trafic actuel est de 60 km/heure, le moteur de routage utilise à nouveau 60 km/heure.

weight

integer (int64)

minimum: 0
maximum: 1000000
0

Poids du véhicule en kilos. La valeur 0 signifie que les restrictions de poids ne sont pas prises en compte.

width

number (double)

minimum: 0
maximum: 1000000
0

Largeur du véhicule en mètres. La valeur 0 signifie que les restrictions de largeur ne sont pas prises en compte.

VehicleLoadTypeEnum

Types de cargaisons pouvant être classifiées comme matières dangereuses et restreintes à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes hazmat américaines 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays. Les valeurs commençant par USHazmat sont destinées au routage américain, tandis que d’autresHazmat doivent être utilisées pour tous les autres pays. vehicleLoadType prend en charge plusieurs valeurs dans une requête.

Valeur Description
USHazmatClass1

Explosifs

USHazmatClass2

Gaz compressé

USHazmatClass3

Liquides combustibles

USHazmatClass4

Solides insinsibles

USHazmatClass5

Oxydants

USHazmatClass6

Poisons

USHazmatClass7

Radioactif

USHazmatClass8

Corrosifs

USHazmatClass9

Divers

otherHazmatExplosive

Explosifs

otherHazmatGeneral

Divers

otherHazmatHarmfulToWater

Nuisible à l’eau