Route - Post Route Directions

Service:

Maps

API Version:

1.0

Permet de calculer un itinéraire entre une origine et une destination donnée, en passant par les points de route spécifiés.

L’API Post Route Directions est une requête HTTP POST qui retourne un itinéraire entre une origine et une destination, en passant par des waypoints s’ils sont spécifiés. L’itinéraire tiendra compte de facteurs tels que la circulation actuelle et les vitesses typiques de la route le jour de la semaine et l’heure de la journée demandés.

Les informations retournées incluent la distance, le temps de trajet estimé et une représentation de la géométrie d’itinéraire. Des informations de routage supplémentaires telles que l’ordre de point de routage optimisé ou les instructions de tour par tour sont également disponibles, en fonction des options sélectionnées.

Le service de routage fournit un ensemble de paramètres pour une description détaillée d’un modèle de consommation spécifique au véhicule. Veuillez case activée modèle de consommation pour obtenir une explication détaillée des concepts et paramètres impliqués.

POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}

With optional parameters:

POST https://atlas.microsoft.com/route/directions/{format}?api-version=1.0&query={query}&maxAlternatives={maxAlternatives}&alternativeType={alternativeType}&minDeviationDistance={minDeviationDistance}&minDeviationTime={minDeviationTime}&instructionsType={instructionsType}&language={language}&computeBestOrder={computeBestOrder}&routeRepresentation={routeRepresentation}&computeTravelTimeFor={computeTravelTimeFor}&vehicleHeading={vehicleHeading}&report=effectiveSettings&sectionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
format	path	True	ResponseFormat	Format souhaité de la réponse. La valeur peut être json ou xml.
api-version	query	True	string	Numéro de version de l’API Azure Maps.
query	query	True	string	Coordonnées par lesquelles l’itinéraire est calculé, délimités par un signe deux-points. Un minimum de deux coordonnées est requis. Le premier est l’origine et le dernier est la destination de l’itinéraire. Les coordonnées facultatives entre les deux agissent en tant que WayPoints dans l’itinéraire. Vous pouvez transmettre jusqu’à 150 WayPoints.
accelerationEfficiency	query		number double	Spécifie l’efficacité de la conversion de l’énergie chimique stockée dans le carburant en énergie cinétique lorsque le véhicule accélère (c’est-à-dire, KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed est obtenu en convertissant le carburant consommé en énergie chimique à l’aide du carburantEnergyDensityInMJoulesPerLiter. Doit être associé à decelerationEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/décélérationEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,33, pour le modèle électrique : 0,66
alternativeType	query		AlternativeRouteType	Contrôle l’optimalité, par rapport aux critères de planification donnés, des alternatives calculées par rapport à l’itinéraire de référence.
arriveAt	query		string date-time	Date et heure d’arrivée au point de destination mis en forme sous la forme d’une dateTime valeur telle que définie dans la section 5.6 de la RFC 3339, avec un décalage de fuseau horaire facultatif. Lorsqu’un décalage de fuseau horaire n’est pas spécifié, il est supposé être celui du point de destination. Exemples : 2023-12-19T16 :39 :57 2023-12-19T16 :39 :57-08 :00 Le arriveAt paramètre ne peut pas être utilisé conjointement avec departAt, minDeviationDistance ou minDeviationTime.
auxiliaryPowerInkW	query		number double	Spécifie la quantité d’énergie consommée pour le maintien en puissance des systèmes auxiliaires, en kilowatts (kW). Il peut être utilisé pour spécifier la consommation due à des appareils et des systèmes tels que les systèmes de climatisation, la radio, le chauffage, etc. Valeurs sensibles : 1.7
auxiliaryPowerInLitersPerHour	query		number double	Spécifie la quantité de carburant consommée pour le maintien des systèmes auxiliaires du véhicule, en litres par heure. Il peut être utilisé pour spécifier la consommation due à des appareils et des systèmes tels que les systèmes de climatisation, la radio, le chauffage, etc. Valeurs sensibles : 0,2
avoid	query		RouteAvoidType[]	Spécifie un élément que le calcul de la route doit essayer d’éviter lors de la détermination de l’itinéraire. Peut être spécifié plusieurs fois dans une seule demande, par exemple, « &avoid=autoroutes&avoid=tollRoads&avoid=ferries ». Dans les demandes de plage de routage, la valeur alreadyUsedRoads ne doit pas être utilisée.
computeBestOrder	query		boolean	Récommandez les points de routage à l’aide d’un algorithme heuristique rapide pour réduire la longueur de l’itinéraire. Obtient de meilleurs résultats lorsqu’il est utilisé conjointement avec routeType le plus court. Notez que l’origine et la destination sont exclues des index de waypoint optimisés. Pour inclure l’origine et la destination dans la réponse, augmentez tous les index de 1 pour tenir compte de l’origine, puis ajoutez la destination comme index final. Les valeurs possibles sont true ou false. True calcule un meilleur ordre si possible, mais n’est pas autorisé à être utilisé conjointement avec la valeur maxAlternatives supérieure à 0 ou conjointement avec des points de waypoint en cercle. False utilise les emplacements dans l’ordre donné et n’est pas autorisé à être utilisé conjointement avec routeRepresentation none.
computeTravelTimeFor	query		ComputeTravelTime	Spécifie s’il faut retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur le trafic (aucun, historique, temps réel) ainsi que le temps de trajet par défaut de meilleure estimation.
constantSpeedConsumptionInkWhPerHundredkm	query		string	Spécifie le composant dépendant de la vitesse de consommation. Fourni sous la forme d’une liste non triée de paires vitesse/débit de consommation. La liste définit des points sur une courbe de consommation. Les taux de consommation pour les vitesses qui ne figurent pas dans la liste sont les suivants : par interpolation linéaire, si la vitesse donnée se situe entre deux vitesses dans la liste par extrapolation linéaire sinon, en supposant une constante (ΔConsumption/ΔSpeed) déterminée par les deux points les plus proches de la liste La liste doit contenir entre 1 et 25 points (inclus) et ne peut pas contenir de points en double pour la même vitesse. S’il ne contient qu’un seul point, le taux de consommation de ce point est utilisé sans traitement supplémentaire. La consommation spécifiée pour la plus grande vitesse doit être supérieure ou égale à celle de l’avant-dernière vitesse la plus grande. Cela garantit que l’extrapolation n’entraîne pas de taux de consommation négatifs. De même, les valeurs de consommation spécifiées pour les deux plus petites vitesses de la liste ne peuvent pas conduire à un taux de consommation négatif pour une vitesse inférieure. La plage valide pour les valeurs de consommation (exprimées en kWh/100 km) est comprise entre 0,01 et 100000.0. Valeurs sensibles : 50,8.2 :130,21.3 Ce paramètre est requis pour le modèle de consommation électrique.
constantSpeedConsumptionInLitersPerHundredkm	query		string	Spécifie le composant dépendant de la vitesse de consommation. Fourni sous la forme d’une liste non triée de vitesses délimitées par deux-points & paires de taux de consommation. La liste définit des points sur une courbe de consommation. Les taux de consommation pour les vitesses qui ne figurent pas dans la liste sont les suivants : par interpolation linéaire, si la vitesse donnée se situe entre deux vitesses dans la liste par extrapolation linéaire sinon, en supposant une constante (ΔConsumption/ΔSpeed) déterminée par les deux points les plus proches de la liste La liste doit contenir entre 1 et 25 points (inclus) et ne peut pas contenir de points en double pour la même vitesse. S’il ne contient qu’un seul point, le taux de consommation de ce point est utilisé sans traitement supplémentaire. La consommation spécifiée pour la plus grande vitesse doit être supérieure ou égale à celle de l’avant-dernière vitesse la plus grande. Cela garantit que l’extrapolation n’entraîne pas de taux de consommation négatifs. De même, les valeurs de consommation spécifiées pour les deux plus petites vitesses de la liste ne peuvent pas conduire à un taux de consommation négatif pour une vitesse inférieure. La plage valide pour les valeurs de consommation (exprimées en l/100 km) est comprise entre 0,01 et 100000,0. Valeurs sensibles : 50,6.3 :130,11.5 Remarque : Ce paramètre est requis pour le modèle de consommation de combustion.
currentChargeInkWh	query		number double	Spécifie l’alimentation électrique actuelle en kilowattheures (kWh). Ce paramètre coexiste avec le paramètre maxChargeInkWh . La plage de valeurs autorisées est comprise entre 0,0 et maxChargeInkWh. Valeurs sensibles : 43
currentFuelInLiters	query		number double	Spécifie l’approvisionnement actuel en carburant en litres. Valeurs sensibles : 55
decelerationEfficiency	query		number double	Spécifie l’efficacité de la conversion de l’énergie cinétique en carburant économisé (non consommé) lorsque le véhicule ralentit (c’est-à-dire, ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved est obtenu en convertissant le carburant économisé (non consommé) en énergie à l’aide du carburantEnergyDensityInMJoulesPerLiter. Doit être associé à accelerationEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/accelerationEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,83, pour le modèle électrique : 0,91
departAt	query		string date-time	Date et heure de départ du point d’origine mis en forme sous la forme d’une dateTime valeur telle que définie dans la section 5.6 de la RFC 3339, avec un décalage de fuseau horaire facultatif. Lorsqu’un décalage de fuseau horaire n’est pas spécifié, il est supposé être celui du point d’origine. Valeur par défaut : maintenant Autre valeur : dateTime Exemples : 2023-12-19T16 :39 :57 2023-12-19T16 :39 :57-08 :00 Le departAt paramètre ne peut pas être utilisé conjointement avec arriveAt.
downhillEfficiency	query		number double	Spécifie l’efficacité de la conversion de l’énergie potentielle en carburant économisé (non consommé) lorsque le véhicule perd de l’élévation (c’est-à-dire, ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved est obtenu en convertissant le carburant économisé (non consommé) en énergie à l’aide du carburantEnergyDensityInMJoulesPerLiter. Doit être associé à uphillEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/uphillEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,51, pour le modèle électrique : 0,73
fuelEnergyDensityInMJoulesPerLiter	query		number double	Spécifie la quantité d’énergie chimique stockée dans un litre de carburant en mégajoules (MJ). Il est utilisé conjointement avec les paramètres *Efficacité pour les conversions entre l’énergie économisée ou consommée et le carburant. Par exemple, la densité énergétique est de 34,2 MJ/l pour l’essence et de 35,8 MJ/l pour le diesel. Ce paramètre est obligatoire si un paramètre *Efficiency est défini. Valeurs sensibles : 34.2
hilliness	query		InclineLevel	Degré de colline pour un itinéraire palpitant. Ce paramètre peut uniquement être utilisé conjointement avec routeType=thrilling.
instructionsType	query		RouteInstructionsType	Si elles sont spécifiées, des instructions d’aide seront retournées. Notez que le paramètre instructionsType ne peut pas être utilisé conjointement avec routeRepresentation=none
language	query		string	Le paramètre language détermine la langue des messages d’aide. Elle n’affecte pas les noms propres (noms de rues, de places, etc.) Elle n’a aucun effet lorsque instructionsType=coded. Les valeurs autorisées sont (un sous-ensemble de) les balises de langue IETF décrites
maxAlternatives	query		integer	Nombre d’itinéraires alternatifs souhaités à calculer. Valeur par défaut : 0, minimum : 0 et maximum : 5
maxChargeInkWh	query		number double	Spécifie la quantité maximale d’énergie électrique en kWh qui peut être stockée dans la batterie du véhicule. Ce paramètre coexiste avec le paramètre currentChargeInkWh . La valeur minimale doit être supérieure ou égale à currentChargeInkWh. Valeurs sensibles : 85
minDeviationDistance	query		integer	Toutes les autres routes retournées suivent l’itinéraire de référence (voir la section Requêtes POST) à partir du point d’origine de la demande calculateRoute pour au moins ce nombre de mètres. Ne peut être utilisé que lors de la reconstruction d’un itinéraire. Le paramètre minDeviationDistance ne peut pas être utilisé conjointement avec arriveAt
minDeviationTime	query		integer	Tous les itinéraires alternatifs retournés suivent l’itinéraire de référence (voir la section Requêtes POST) à partir du point d’origine de la demande calculateRoute pendant au moins ce nombre de secondes. Ne peut être utilisé que lors de la reconstruction d’un itinéraire. Le paramètre minDeviationTime ne peut pas être utilisé conjointement avec arriveAt. La valeur par défaut est 0. La définition de )minDeviationTime_ à une valeur supérieure à zéro a les conséquences suivantes : Le point d’origine de la demande calculateRoute doit se trouver sur (ou très près) de l’itinéraire de référence d’entrée. Si ce n’est pas le cas, une erreur est retournée. Toutefois, le point d’origine n’a pas besoin d’être au début de la route de référence d’entrée (il peut être considéré comme la position actuelle du véhicule sur l’itinéraire de référence). L’itinéraire de référence, retourné en tant que première route de la réponse calculateRoute , démarre au point d’origine spécifié dans la demande calculateRoute . La partie initiale de l’itinéraire de référence d’entrée jusqu’au point d’origine est exclue de la réponse. Les valeurs de minDeviationDistance et minDeviationTime déterminent dans quelle mesure les itinéraires alternatifs seront garantis pour suivre l’itinéraire de référence à partir du point d’origine. L’itinéraire doit utiliser departAt. La propriété vehicleHeading est ignorée.
report	query		Report	Spécifie les données à signaler à des fins de diagnostic. La seule valeur possible est effectiveSettings. Signale les paramètres ou données effectifs utilisés lors de l’appel de l’API. Dans le cas des paramètres par défaut, la valeur par défaut est reflétée lorsque le paramètre n’a pas été spécifié par l’appelant.
routeRepresentation	query		RouteRepresentationForBestOrder	Spécifie la représentation de l’ensemble d’itinéraires fournis en tant que réponse. Cette valeur de paramètre peut uniquement être utilisée conjointement avec computeBestOrder=true.
routeType	query		RouteType	Type d’itinéraire demandé.
sectionType	query		SectionType	Spécifie les types de section signalés dans la réponse de routage. Par exemple, si sectionType = piéton, les sections qui conviennent uniquement aux piétons sont retournées. Plusieurs types peuvent être utilisés. Le sectionType par défaut fait référence à l’entrée travelMode. Par défaut, travelMode est défini sur car
traffic	query		boolean	Valeurs possibles : true : tenez compte de toutes les informations de trafic disponibles pendant le routage false : ignorez les données de trafic actuelles pendant le routage. Notez que bien que les données actuelles sur la circulation soient ignorées pendant le routage, l’effet du trafic historique sur la vitesse effective des routes est toujours incorporé.
travelMode	query		TravelMode	Mode de déplacement pour l’itinéraire demandé. Si elle n’est pas définie, la valeur par défaut est « car ». Notez que le travelMode demandé peut ne pas être disponible pour l’ensemble de l’itinéraire. Si le travelMode demandé n’est pas disponible pour une section particulière, l’élément travelMode de la réponse pour cette section sera « autre ». Notez que les modes de voyage bus, moto, taxi et fourgon sont des fonctionnalités BETA. Les données de restriction complètes ne sont pas disponibles dans toutes les zones.
uphillEfficiency	query		number double	Spécifie l’efficacité de la conversion de l’énergie chimique stockée dans le carburant en énergie potentielle lorsque le véhicule gagne en élévation (par exemple, PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed est obtenu en convertissant le carburant consommé en énergie chimique à l’aide du carburantEnergyDensityInMJoulesPerLiter. Doit être associé à downhillEfficiency. La plage de valeurs autorisées est comprise entre 0,0 et 1/downhillEfficiency. Valeurs sensibles : pour le modèle de combustion : 0,27, pour le modèle électrique : 0,74
vehicleAxleWeight	query		integer	Poids par essieu du véhicule en kg. La valeur 0 signifie que les restrictions de poids par essieu ne sont pas prises en compte.
vehicleCommercial	query		boolean	Indique si le véhicule est utilisé à des fins commerciales. Les véhicules commerciaux peuvent ne pas être autorisés à circuler sur certaines routes.
vehicleEngineType	query		VehicleEngineType	Type de moteur du véhicule. Lorsqu’un modèle de consommation détaillé est spécifié, il doit être cohérent avec la valeur de vehicleEngineType.
vehicleHeading	query		integer	Direction du véhicule en degrés commençant au vrai Nord et continuant dans le sens des aiguilles d’une montre. Le nord est à 0 degrés, l’est à 90 degrés, le sud à 180 degrés, l’ouest à 270 degrés. Valeurs possibles 0-359
vehicleHeight	query		number double	Hauteur du véhicule en mètres. La valeur 0 signifie que les restrictions de hauteur ne sont pas prises en compte.
vehicleLength	query		number double	Longueur du véhicule en mètres. La valeur 0 signifie que les restrictions de longueur ne sont pas prises en compte.
vehicleLoadType	query		VehicleLoadType	Types de marchandises qui peuvent être classées comme des matières dangereuses et restreintes à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes US Hazmat 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays/régions. 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/régions. vehicleLoadType peut être spécifié plusieurs fois. Ce paramètre est actuellement pris en compte uniquement pour travelMode=truck.
vehicleMaxSpeed	query		integer	Vitesse maximale du véhicule en km/heure. La vitesse maximale dans le profil du véhicule est utilisée pour case activée 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 lors de la planification de l’itinéraire. Une valeur autre que zéro 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 considérera 60 km/heure, car c’est la situation actuelle. Si la vitesse maximale du véhicule est de 80 km/heure, mais que la circulation actuelle est de 60 km/heure, le moteur de routage utilise à nouveau 60 km/heure.
vehicleWeight	query		integer	Poids du véhicule en kilogrammes. Il est obligatoire si l’un des paramètres *Efficacité est défini. Il doit être strictement positif lorsqu’il est utilisé dans le contexte du modèle de consommation. Les restrictions de poids sont prises en compte. Si aucun modèle de consommation détaillé n’est spécifié et que la valeur de vehicleWeight est différente de zéro, les restrictions de poids sont prises en compte. Dans tous les autres cas, ce paramètre est ignoré. Valeurs sensibles : pour le modèle de combustion : 1600, pour le modèle électrique : 1900
vehicleWidth	query		number double	Largeur du véhicule en mètres. La valeur 0 signifie que les restrictions de largeur ne sont pas prises en compte.
windingness	query		WindingnessLevel	Niveau de virages pour un itinéraire palpitant. Ce paramètre peut uniquement être utilisé conjointement avec routeType=thrilling.

En-tête de la demande

Nom	Obligatoire	Type	Description
x-ms-client-id		string	Spécifie quel compte est destiné à être utilisé conjointement avec le modèle de sécurité Microsoft Entra ID. Il représente un ID unique pour le compte Azure Maps et peut être récupéré à partir de l’API compte du plan de gestion Azure Maps. Pour utiliser Microsoft Entra ID sécurité dans Azure Maps consultez les articles suivants pour obtenir des conseils.

Corps de la demande

Nom	Type	Description
allowVignette	string[]	Il s’agit d’une liste de codes pays à 3 caractères, ISO 3166-1, alpha-3 des pays/régions dans lesquels les routes à péage avec vignettes sont autorisées, par exemple « AUS,CHE ». Spécifier allowVignette avec certains pays/régions X équivaut à spécifier avoidVignette avec tous les pays/régions, mais X. Spécifier allowVignette avec une liste vide revient à éviter toutes les routes à péage avec des vignettes. Remarque : Il s’agit d’une erreur de spécifier à la fois avoidVignette et allowVignette.
avoidAreas	GeoJsonMultiPolygon	Un MultiPolygon GeoJSON représentant la liste des zones à éviter. Seuls les polygones rectangles sont pris en charge. La taille maximale d’un rectangle est d’environ 160x160 km. Le nombre maximal de zones évitées est de 10. Il ne peut pas traverser le 180e méridien. Elle doit être comprise entre -80 et +80 degrés de latitude.
avoidVignette	string[]	Il s’agit d’une liste de 3 caractères, ISO 3166-1, alpha-3 des codes pays/régions dans lesquels toutes les routes à péage avec vignettes doivent être évitées, par exemple « AUS, CHE ». Les routes à péage avec vignettes dans les pays/régions qui ne figurent pas dans la liste ne sont pas affectées. Remarque : Il s’agit d’une erreur de spécifier à la fois avoidVignette et allowVignette.
supportingPoints	GeoJsonGeometryCollection	Collection GeoJSON Geometry représentant une séquence de coordonnées utilisée comme entrée pour la reconstruction d’itinéraire et pour le calcul de zéro ou plusieurs itinéraires alternatifs à cet itinéraire de référence. La séquence de points de prise en charge fournie est utilisée comme entrée pour la reconstruction de l’itinéraire. Les itinéraires alternatifs sont calculés entre les points d’origine et de destination spécifiés dans les emplacements des paramètres de chemin d’accès de base. Si minDeviationDistance et minDeviationTime sont définis sur zéro, ces points d’origine et de destination sont censés se trouver respectivement au début et à la fin de l’itinéraire de référence (ou très près). Les emplacements intermédiaires (waypoints) ne sont pas pris en charge lors de l’utilisation de <supportsPoints>. L’itinéraire de référence peut contenir des incidents de trafic de type ROAD_CLOSURE, qui sont ignorés pour le calcul du temps de trajet et du délai de trafic de l’itinéraire de référence. Pour plus d’informations, consultez Points de prise en charge .

Réponses

Nom	Type	Description
200 OK	RouteDirections	Ok
Other Status Codes	ErrorResponse	Une erreur inattendue s’est produite.

Sécurité

AADToken

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

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

Notes

• Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer à quelle ressource Azure Maps l’application demande l’accès. Vous pouvez l’acquérir à partir de l’API de gestion Maps.

Authorization URL est spécifique au cloud public Azure instance. Les clouds souverains ont des URL d’autorisation et des configurations Microsoft Entra ID uniques. * Le contrôle d’accès en fonction du rôle Azure est configuré à partir du plan de gestion Azure via Portail Azure, PowerShell, CLI, sdk Azure ou API REST. * L’utilisation du Kit de développement logiciel (SDK) web Azure Maps permet une configuration basée sur la configuration d’une application pour plusieurs cas d’usage.

• Pour plus d’informations sur Plateforme d'identités Microsoft, consultez Plateforme d'identités Microsoft vue d’ensemble.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Il s’agit d’une clé partagée qui est provisionnée lorsque vous Create un compte Azure Maps dans le Portail Azure ou à l’aide de PowerShell, de l’interface CLI, des SDK Azure ou de l’API REST.

Avec cette clé, n’importe quelle application peut accéder à toutes les API REST. En d’autres termes, cette clé peut être utilisée comme clé master dans le compte dans lequel elle est émise.

Pour les applications exposées publiquement, notre recommandation est d’utiliser l’approche des applications clientes confidentielles pour accéder à Azure Maps API REST afin que votre clé puisse être stockée en toute sécurité.

Type: apiKey
In: query

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 Portail Azure, PowerShell, CLI, kits SDK Azure ou 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 de grain 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, notre recommandation est de configurer une liste spécifique d’origines autorisées sur la ressource de compte Map afin de limiter les abus de rendu et de renouveler régulièrement le jeton SAP.

Type: apiKey
In: header

Exemples

Successfully retrieve a route between an origin and a destination with additional parameters in the body

Sample Request

HTTP

POST https://atlas.microsoft.com/route/directions/json?api-version=1.0&query=52.50931,13.42936:52.50274,13.43872&report=effectiveSettings

{
  "supportingPoints": {
    "type": "GeometryCollection",
    "geometries": [
      {
        "type": "Point",
        "coordinates": [
          13.42936,
          52.5093
        ]
      },
      {
        "type": "Point",
        "coordinates": [
          13.42859,
          52.50844
        ]
      }
    ]
  },
  "avoidVignette": [
    "AUS",
    "CHE"
  ],
  "avoidAreas": {
    "type": "MultiPolygon",
    "coordinates": [
      [
        [
          [
            -122.39456176757811,
            47.489368981370724
          ],
          [
            -122.00454711914061,
            47.489368981370724
          ],
          [
            -122.00454711914061,
            47.65151268066222
          ],
          [
            -122.39456176757811,
            47.65151268066222
          ],
          [
            -122.39456176757811,
            47.489368981370724
          ]
        ]
      ],
      [
        [
          [
            100,
            0
          ],
          [
            101,
            0
          ],
          [
            101,
            1
          ],
          [
            100,
            1
          ],
          [
            100,
            0
          ]
        ]
      ]
    ]
  }
}

Sample Response

Status code:

200

{
  "formatVersion": "0.0.12",
  "routes": [
    {
      "summary": {
        "lengthInMeters": 1147,
        "travelTimeInSeconds": 162,
        "trafficDelayInSeconds": 0,
        "departureTime": "2017-09-07T16:56:58+00:00",
        "arrivalTime": "2017-09-07T16:59:40+00:00"
      },
      "legs": [
        {
          "summary": {
            "lengthInMeters": 1147,
            "travelTimeInSeconds": 162,
            "trafficDelayInSeconds": 0,
            "departureTime": "2017-09-07T16:56:58+00:00",
            "arrivalTime": "2017-09-07T16:59:40+00:00"
          },
          "points": [
            {
              "latitude": 52.50931,
              "longitude": 13.42937
            },
            {
              "latitude": 52.50904,
              "longitude": 13.42912
            },
            {
              "latitude": 52.50894,
              "longitude": 13.42904
            },
            {
              "latitude": 52.50867,
              "longitude": 13.42879
            },
            {
              "latitude": 52.5084,
              "longitude": 13.42857
            },
            {
              "latitude": 52.50791,
              "longitude": 13.42824
            },
            {
              "latitude": 52.50757,
              "longitude": 13.42772
            },
            {
              "latitude": 52.50735,
              "longitude": 13.42823
            },
            {
              "latitude": 52.5073,
              "longitude": 13.42836
            },
            {
              "latitude": 52.50573,
              "longitude": 13.43194
            },
            {
              "latitude": 52.50512,
              "longitude": 13.43336
            },
            {
              "latitude": 52.50464,
              "longitude": 13.43451
            },
            {
              "latitude": 52.5045,
              "longitude": 13.43481
            },
            {
              "latitude": 52.50443,
              "longitude": 13.43498
            },
            {
              "latitude": 52.50343,
              "longitude": 13.43737
            },
            {
              "latitude": 52.50274,
              "longitude": 13.43872
            }
          ]
        }
      ],
      "sections": [
        {
          "startPointIndex": 0,
          "endPointIndex": 15,
          "sectionType": "TRAVEL_MODE",
          "travelMode": "car"
        }
      ]
    }
  ]
}

Définitions

Nom	Description
AlternativeRouteType	Contrôle l’optimalité, par rapport aux critères de planification donnés, des alternatives calculées par rapport à l’itinéraire de référence.
ComputeTravelTime	Spécifie s’il faut retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur la circulation (aucun, historique, temps réel) ainsi que de la meilleure estimation par défaut du temps de trajet.
DelayMagnitude	Ampleur du délai causé par l’incident. Ces valeurs correspondent aux valeurs du champ de réponse ty de l’API Obtenir le détail des incidents de trafic.
DrivingSide	Indique la conduite côté gauche par rapport à droite au point de la manœuvre.
EffectiveSetting	Paramètre effectif ou données utilisées lors de l’appel de cette API route.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
GeoJsonGeometry	Objet geometry valide GeoJSON . Le type doit être l’un des sept types géométriques GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, consultez RFC 7946 .
GeoJsonGeometryCollection	Type d’objet valide GeoJSON GeometryCollection . Pour plus d’informations, consultez RFC 7946 .
GeoJsonLineString	Type geometry valide GeoJSON LineString . Pour plus d’informations, consultez RFC 7946 .
GeoJsonMultiLineString	Type geometry valide GeoJSON MultiLineString . Pour plus d’informations, consultez RFC 7946 .
GeoJsonMultiPoint	Type geometry valide GeoJSON MultiPoint . Pour plus d’informations, consultez RFC 7946 .
GeoJsonMultiPolygon	Type d’objet valide GeoJSON MultiPolygon . Pour plus d’informations, consultez RFC 7946 .
GeoJsonPoint	Type geometry valide GeoJSON Point . Pour plus d’informations, consultez RFC 7946 .
GeoJsonPolygon	Type de géométrie valide GeoJSON Polygon . Pour plus d’informations, consultez RFC 7946 .
GuidanceInstructionType	Type de l’instruction, par exemple, virage ou changement de formulaire de route.
GuidanceManeuver	Code identifiant la manœuvre.
InclineLevel	Degré de colline pour un itinéraire palpitant. Ce paramètre ne peut être utilisé qu’avec routeType=thrilling.
JunctionType	Type de la jonction où la manœuvre a lieu. Pour les grands ronds-points, deux instructions distinctes sont générées pour entrer et sortir du rond-point.
LatLongPair	Emplacement représenté sous la forme d’une latitude et d’une longitude.
Report	Spécifie les données à signaler à des fins de diagnostic. La seule valeur possible est effectiveSettings. Signale les paramètres ou données effectifs utilisés lors de l’appel de l’API. Dans le cas des paramètres par défaut, la valeur par défaut est reflétée lorsque le paramètre n’a pas été spécifié par l’appelant.
ResponseFormat	Format souhaité de la réponse. La valeur peut être json ou xml.
ResponseSectionType	Types de section de la réponse de routage signalée
ResponseTravelMode	Mode voyage pour l’itinéraire calculé. La valeur est définie other sur si le mode de transport demandé n’est pas possible dans cette section
Route
RouteAvoidType	Spécifie quelque chose que le calcul de l’itinéraire doit essayer d’éviter lors de la détermination de l’itinéraire. Peut être spécifié plusieurs fois dans une même demande, par exemple , '&avoid=highways&avoid=tollRoads&avoid=ferries'. Dans les demandes de plage de routes, la valeur alreadyUsedRoads ne doit pas être utilisée.
RouteDirectionParameters	Paramètres de post-corps pour les itinéraires.
RouteDirections	Cet objet est retourné à partir d’un appel d’itinéraire réussi
RouteGuidance	Contient des éléments liés à l’aide. Ce champ n’est présent que lorsque des instructions ont été demandées et sont disponibles.
RouteInstruction	Ensemble d’attributs décrivant une manœuvre, par exemple« Tourner à droite », « Rester à gauche », « Prendre le ferry », « Prendre l’autoroute », « Arriver ».
RouteInstructionGroup	Groupes une séquence d’éléments d’instruction qui sont liés les uns aux autres. La plage de séquences est limitée par firstInstructionIndex et lastInstructionIndex. Lorsque des messages texte lisibles par l’homme sont demandés pour obtenir des conseils (instructionType=text ou tagged), un message de synthèse est retourné au groupe d’instructions lorsqu’il est disponible.
RouteInstructionsType	Si elle est spécifiée, des instructions d’aide sont retournées. Notez que le paramètre instructionsType ne peut pas être utilisé conjointement avec routeRepresentation=none
RouteLeg	Description d’une partie d’un itinéraire, composée d’une liste de points. Chaque point de chemin supplémentaire fourni dans la demande entraîne une étape supplémentaire dans l’itinéraire retourné.
RouteLegSummary	Objet récapitulative pour la section route.
RouteOptimizedWaypoint	Objet point de chemin optimisé.
RouteReport	Indique les paramètres effectifs utilisés dans l’appel actuel.
RouteRepresentationForBestOrder	Spécifie la représentation de l’ensemble d’itinéraires fourni en tant que réponse. Cette valeur de paramètre ne peut être utilisée qu’avec computeBestOrder=true.
RouteSection	Les sections de routage contiennent des informations supplémentaires sur les parties d’un itinéraire. Chaque section contient au moins les éléments startPointIndex, endPointIndexet sectionType.
RouteSectionTec	Détails de l’événement de trafic, à l’aide de définitions dans la norme TPEG2-TEC . Peut contenir des éléments effectCode et causes.
RouteSectionTecCause	Cause de l’événement de trafic. Peut contenir des éléments mainCauseCode et subCauseCode. Peut être utilisé pour définir l’iconographie et les descriptions.
RouteSummary	Objet Summary
RouteType	Type d’itinéraire demandé.
SectionType	Spécifie les types de section signalés dans la réponse d’itinéraire. Par exemple, si sectionType = piéton, les sections qui conviennent uniquement aux piétons sont retournées. Plusieurs types peuvent être utilisés. Le sectionType par défaut fait référence à l’entrée travelMode. Par défaut, travelMode est défini sur car
SimpleCategory	Type de l’incident. Actuellement, il peut s’agir de JAM, ROAD_WORK, ROAD_CLOSURE ou AUTRE. Pour plus d’informations, consultez « tec ».
TravelMode	Mode de déplacement pour l’itinéraire demandé. Si elle n’est pas définie, la valeur par défaut est « car ». Notez que le travelMode demandé peut ne pas être disponible pour l’ensemble de l’itinéraire. Si le travelMode demandé n’est pas disponible pour une section particulière, l’élément travelMode de la réponse pour cette section sera « other ». Notez que les modes de voyage bus, moto, taxi et fourgonnette sont des fonctionnalités BÊTA. Les données de restriction complètes ne sont pas disponibles dans toutes les zones.
VehicleEngineType	Type de moteur du véhicule. Lorsqu’un modèle de consommation détaillé est spécifié, il doit être cohérent avec la valeur de vehicleEngineType.
VehicleLoadType	Types de cargaisons qui peuvent être classées comme des matières dangereuses et interdites à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes US Hazmat 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays/régions. Les valeurs commençant par USHazmat sont destinées au routage des États-Unis, tandis que otherHazmat doit être utilisé pour tous les autres pays/régions. vehicleLoadType peut être spécifié plusieurs fois. Ce paramètre est actuellement pris en compte uniquement pour travelMode=truck.
WindingnessLevel	Niveau de virages pour un itinéraire palpitant. Ce paramètre ne peut être utilisé qu’avec routeType=thrilling.

AlternativeRouteType

Contrôle l’optimalité, par rapport aux critères de planification donnés, des alternatives calculées par rapport à l’itinéraire de référence.

Nom	Type	Description
anyRoute	string	Autorisez le retour d’une autre route, quelle que soit la façon dont elle se compare à l’itinéraire de référence en termes d’optimalité.
betterRoute	string	Retourne une autre route uniquement si elle est meilleure que l’itinéraire de référence selon les critères de planification donnés.

ComputeTravelTime

Spécifie s’il faut retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur la circulation (aucun, historique, temps réel) ainsi que de la meilleure estimation par défaut du temps de trajet.

Nom	Type	Description
all	string	Calcule les temps de trajet pour tous les types d’informations sur le trafic et spécifie tous les résultats dans les champs noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds et liveTrafficIncidentsTravelTimeInSeconds inclus dans les résumés dans la réponse d’itinéraire.
none	string	Ne calcule pas les temps de trajet supplémentaires.

DelayMagnitude

Ampleur du délai causé par l’incident. Ces valeurs correspondent aux valeurs du champ de réponse ty de l’API Obtenir le détail des incidents de trafic.

Nom	Type	Description
0	string	Inconnu.
1	string	Mineur.
2	string	Modéré.
3	string	Majeur.
4	string	Non défini, utilisé pour les fermetures de routes et autres retards indéfinis.

DrivingSide

Indique la conduite côté gauche par rapport à droite au point de la manœuvre.

Nom	Type	Description
LEFT	string	Gauche.
RIGHT	string	Côté droit.

EffectiveSetting

Paramètre effectif ou données utilisées lors de l’appel de cette API route.

Nom	Type	Description
key	string	Nom du paramètre utilisé.
value	string	Valeur du paramètre utilisé.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet error.

GeoJsonGeometry

Objet geometry valide GeoJSON . Le type doit être l’un des sept types géométriques GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon et GeometryCollection. Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
type	GeoJsonObjectType	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonGeometryCollection

Type d’objet valide GeoJSON GeometryCollection . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Contient une liste d’objets géométriques valides GeoJSON . Notez que les coordonnées dans GeoJSON sont dans l’ordre x, y (longitude, latitude).
type	string: GeometryCollection	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonLineString

Type geometry valide GeoJSON LineString . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Coordonnées de la GeoJson LineString géométrie.
type	string: LineString	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiLineString

Type geometry valide GeoJSON MultiLineString . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Coordonnées de la GeoJson MultiLineString géométrie.
type	string: MultiLineString	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiPoint

Type geometry valide GeoJSON MultiPoint . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Coordonnées de la GeoJson MultiPoint géométrie.
type	string: MultiPoint	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonMultiPolygon

Type d’objet valide GeoJSON MultiPolygon . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Contient une liste d’objets valides GeoJSON Polygon . Notez que les coordonnées dans GeoJSON sont dans l’ordre x, y (longitude, latitude).
type	string: MultiPolygon	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonPoint

Type geometry valide GeoJSON Point . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Un Position est un tableau de nombres avec deux éléments ou plus. Les deux premiers éléments sont la longitude et la latitude, précisément dans cet ordre. Altitude/Elevation est un troisième élément facultatif. Pour plus d’informations, consultez RFC 7946 .
type	string: Point	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GeoJsonPolygon

Type de géométrie valide GeoJSON Polygon . Pour plus d’informations, consultez RFC 7946 .

Nom	Type	Description
coordinates	number[]	Coordonnées du GeoJson Polygon type geometry.
type	string: Polygon	Spécifie le type GeoJSON. Doit être l’un des neuf types d’objets GeoJSON valides : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature et FeatureCollection.

GuidanceInstructionType

Type de l’instruction, par exemple, virage ou changement de formulaire de route.

Nom	Type	Description
DIRECTION_INFO	string	Informations de direction.
LOCATION_ARRIVAL	string	Emplacement d’arrivée.
LOCATION_DEPARTURE	string	Lieu de départ.
LOCATION_WAYPOINT	string	Emplacement du point de chemin.
ROAD_CHANGE	string	Changement de route.
TURN	string	Tourner.

GuidanceManeuver

Code identifiant la manœuvre.

Nom	Type	Description
ARRIVE	string	Tu es arrivé.
ARRIVE_LEFT	string	Tu es arrivé. Votre destination se trouve à gauche.
ARRIVE_RIGHT	string	Tu es arrivé. Votre destination est à droite.
BEAR_LEFT	string	Ours à gauche.
BEAR_RIGHT	string	Portez à droite.
DEPART	string	Laisser.
ENTER_FREEWAY	string	Prenez l’autoroute.
ENTER_HIGHWAY	string	Prenez l’autoroute.
ENTER_MOTORWAY	string	Prendre l’autoroute.
ENTRANCE_RAMP	string	Prenez la rampe.
FOLLOW	string	Suivre.
KEEP_LEFT	string	Restez à gauche.
KEEP_RIGHT	string	Gardez la droite.
MAKE_UTURN	string	Faites un demi-tour.
MOTORWAY_EXIT_LEFT	string	Prendre la sortie de gauche.
MOTORWAY_EXIT_RIGHT	string	Prendre la sortie à droite.
ROUNDABOUT_BACK	string	Faire le tour du rond-point.
ROUNDABOUT_CROSS	string	Traverser le rond-point.
ROUNDABOUT_LEFT	string	Au rond-point, prendre la sortie à gauche.
ROUNDABOUT_RIGHT	string	Au rond-point, prendre la sortie à droite.
SHARP_LEFT	string	Tourner vers la gauche.
SHARP_RIGHT	string	Tourner à droite.
STRAIGHT	string	Restez droit.
SWITCH_MAIN_ROAD	string	Passez à la route main.
SWITCH_PARALLEL_ROAD	string	Basculez vers la route parallèle.
TAKE_EXIT	string	Prenez la sortie.
TAKE_FERRY	string	Prenez le ferry.
TRY_MAKE_UTURN	string	Essayez de faire un demi-tour.
TURN_LEFT	string	Tourner à gauche.
TURN_RIGHT	string	Tourner à droite.
WAYPOINT_LEFT	string	Vous avez atteint le point de passage. Il est à gauche.
WAYPOINT_REACHED	string	Vous avez atteint le point de passage.
WAYPOINT_RIGHT	string	Vous avez atteint le point de passage. C’est à droite.

InclineLevel

Degré de colline pour un itinéraire palpitant. Ce paramètre ne peut être utilisé qu’avec routeType=thrilling.

Nom	Type	Description
high	string	high
low	string	low
normal	string	normal

JunctionType

Type de la jonction où la manœuvre a lieu. Pour les grands ronds-points, deux instructions distinctes sont générées pour entrer et sortir du rond-point.

Nom	Type	Description
BIFURCATION	string	bifurcation
REGULAR	string	regular
ROUNDABOUT	string	Rond-point

LatLongPair

Emplacement représenté sous la forme d’une latitude et d’une longitude.

Nom	Type	Description
latitude	number	Propriété Latitude
longitude	number	Longitude, propriété

Report

Spécifie les données à signaler à des fins de diagnostic. La seule valeur possible est effectiveSettings. Signale les paramètres ou données effectifs utilisés lors de l’appel de l’API. Dans le cas des paramètres par défaut, la valeur par défaut est reflétée lorsque le paramètre n’a pas été spécifié par l’appelant.

Nom	Type	Description
effectiveSettings	string	Signale les paramètres ou données effectifs utilisés lors de l’appel de l’API.

ResponseFormat

Format souhaité de la réponse. La valeur peut être json ou xml.

Nom	Type	Description
json	string	Format d’échange de données de notation d’objet JavaScript
xml	string	Langage de balisage extensible

ResponseSectionType

Types de section de la réponse de routage signalée

Nom	Type	Description
CARPOOL	string	Sections de l’itinéraire qui nécessitent l’utilisation de voies de covoiturage (HOV/High Occupationy Vehicle).
CAR_TRAIN	string	Sections de l’itinéraire qui sont des voitures ou des trains.
COUNTRY	string	Sections indiquant les pays/régions dans lesquels se trouve l’itinéraire.
FERRY	string	Sections de la route qui sont des traversiers.
MOTORWAY	string	Sections de la route qui sont des autoroutes.
PEDESTRIAN	string	Sections de l’itinéraire qui ne sont adaptées qu’aux piétons.
TOLL_ROAD	string	Sections de l’itinéraire qui nécessitent un péage à payer.
TOLL_VIGNETTE	string	Sections de l’itinéraire qui nécessitent la présence d’une vignette de péage.
TRAFFIC	string	Sections de l’itinéraire qui contiennent des informations sur le trafic.
TRAVEL_MODE	string	Sections relatives au paramètre travelModede requête .
TUNNEL	string	Sections de l’itinéraire qui sont des tunnels.
URBAN	string	Sections de l’itinéraire situées dans des zones urbaines.

ResponseTravelMode

Mode voyage pour l’itinéraire calculé. La valeur est définie other sur si le mode de transport demandé n’est pas possible dans cette section

Nom	Type	Description
bicycle	string	Les itinéraires retournés sont optimisés pour les bicyclettes, y compris l’utilisation de voies cyclables.
bus	string	Les itinéraires retournés sont optimisés pour les autobus, y compris l’utilisation de voies réservées aux autobus. Fonctionnalité BÊTA.
car	string	Les itinéraires retournés sont optimisés pour les voitures.
motorcycle	string	Les itinéraires retournés sont optimisés pour les motos. Fonctionnalité BÊTA.
other	string	Le mode de transport donné n’est pas possible dans cette section
pedestrian	string	Les itinéraires retournés sont optimisés pour les piétons, y compris l’utilisation des trottoirs.
taxi	string	Les itinéraires retournés sont optimisés pour les taxis. Fonctionnalité BÊTA.
truck	string	Les itinéraires retournés sont optimisés pour les véhicules commerciaux, comme pour les camions.
van	string	Les itinéraires retournés sont optimisés pour les fourgonnettes. Fonctionnalité BÊTA.

Route

Nom	Type	Description
guidance	RouteGuidance	Contient des éléments liés à l’aide. Ce champ est présent uniquement lorsque des conseils ont été demandés et sont disponibles.
legs	RouteLeg[]	Tableau d’jambes
sections	RouteSection[]	Tableau sections
summary	RouteSummary	Objet Summary

RouteAvoidType

Spécifie quelque chose que le calcul de l’itinéraire doit essayer d’éviter lors de la détermination de l’itinéraire. Peut être spécifié plusieurs fois dans une même demande, par exemple , '&avoid=highways&avoid=tollRoads&avoid=ferries'. Dans les demandes de plage de routes, la valeur alreadyUsedRoads ne doit pas être utilisée.

Nom	Type	Description
alreadyUsedRoads	string	Évite d’utiliser la même route plusieurs fois. Plus utile en conjonction avec routeType=palpitant.
borderCrossings	string	Évite les passages aux frontières dans le calcul de l’itinéraire.
carpools	string	Évite les itinéraires qui nécessitent l’utilisation de voies de covoiturage (HOV/High Occupationy Vehicle).
ferries	string	Évite les traversiers
motorways	string	Évite les autoroutes
tollRoads	string	Évite les routes à péage.
unpavedRoads	string	Évite les routes non pavées

RouteDirectionParameters

Paramètres de post-corps pour les itinéraires.

Nom	Type	Description
allowVignette	string[]	Il s’agit d’une liste de codes pays à 3 caractères, ISO 3166-1, alpha-3 des pays/régions dans lesquels les routes à péage avec vignettes sont autorisées, par exemple « AUS,CHE ». Spécifier allowVignette avec certains pays/régions X équivaut à spécifier avoidVignette avec tous les pays/régions, mais X. Spécifier allowVignette avec une liste vide revient à éviter toutes les routes à péage avec des vignettes. Remarque : Spécifier à la fois avoidVignette et allowVignette est une erreur.
avoidAreas	GeoJsonMultiPolygon	MultiPolygon GeoJSON représentant la liste des zones à éviter. Seuls les polygones rectangles sont pris en charge. La taille maximale d’un rectangle est d’environ 160 x 160 km. Le nombre maximal de zones évitées est de 10. Il ne peut pas traverser le 180e méridien. Elle doit être comprise entre -80 et +80 degrés de latitude.
avoidVignette	string[]	Il s’agit d’une liste de 3 caractères, ISO 3166-1, alpha-3 des pays/régions dans lesquels toutes les routes à péage avec vignettes doivent être évitées, par exemple « AUS, CHE ». Les routes à péage avec vignettes dans les pays/régions qui ne figurent pas dans la liste ne sont pas affectées. Remarque : Spécifier à la fois avoidVignette et allowVignette est une erreur.
supportingPoints	GeoJsonGeometryCollection	Collection GeoJSON Geometry représentant une séquence de coordonnées utilisée comme entrée pour la reconstruction d’itinéraire et pour le calcul de zéro ou plusieurs itinéraires alternatifs à cet itinéraire de référence. La séquence de points de support fournie est utilisée comme entrée pour la reconstruction de l’itinéraire. Les itinéraires alternatifs sont calculés entre les points d’origine et de destination spécifiés dans les emplacements des paramètres de chemin d’accès de base. Si minDeviationDistance et minDeviationTime sont tous deux définis sur zéro, ces points d’origine et de destination sont censés se trouver au début (ou très proche) de la route de référence, respectivement. Les emplacements intermédiaires (waypoints) ne sont pas pris en charge lors de l’utilisation de <supportsPoints>. L’itinéraire de référence peut contenir des incidents de trafic de type ROAD_CLOSURE, qui sont ignorés pour le calcul du temps de trajet de l’itinéraire de référence et du délai de trafic. Pour plus d’informations, consultez Points de support .

RouteDirections

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

Nom	Type	Description
formatVersion	string	Propriété Format Version
optimizedWaypoints	RouteOptimizedWaypoint[]	Séquence optimisée de points de cheminement. Il affiche l’index de la séquence de point de chemin fournie par l’utilisateur pour la liste d’origine et optimisée. Pour instance, une réponse : <optimizedWaypoints> <waypoint providedIndex="0" optimizedIndex="1"/> <waypoint providedIndex="1" optimizedIndex="2"/> <waypoint providedIndex="2" optimizedIndex="0"/> </optimizedWaypoints> signifie que la séquence d’origine est [0, 1, 2] et la séquence optimisée est [1, 2, 0]. Étant donné que l’index commence par 0, l’original est « first, second, third » tandis que l’optimisé est « second, third, first ».
report	RouteReport	Indique les paramètres effectifs utilisés dans l’appel actuel.
routes	Route[]	Tableau d’itinéraires

RouteGuidance

Contient des éléments liés à l’aide. Ce champ n’est présent que lorsque des instructions ont été demandées et sont disponibles.

Nom	Type	Description
instructionGroups	RouteInstructionGroup[]	Groupes une séquence d’éléments d’instruction qui sont liés les uns aux autres.
instructions	RouteInstruction[]	Liste d’instructions décrivant les manœuvres.

RouteInstruction

Ensemble d’attributs décrivant une manœuvre, par exemple« Tourner à droite », « Rester à gauche », « Prendre le ferry », « Prendre l’autoroute », « Arriver ».

Nom	Type	Description
combinedMessage	string	Message lisible par l’homme pour la manœuvre combiné au message de l’instruction suivante. Il est parfois possible de combiner deux instructions successives en une seule instruction, ce qui facilite le suivi. Dans ce cas, l’indicateur possibleCombineWithNext est true. Par exemple : 10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam 11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam L’indicateur possibleCombineWithNext de l’instruction 10 est true. Cela indique aux clients des instructions codées qu’elles peuvent être combinées à l’instruction 11. Les instructions seront combinées automatiquement pour les clients qui demandent des conseils lisibles par l’utilisateur. Le champ combinedMessage contient le message combiné : Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam then follow Einsteinweg/A10/E22 towards Ring Amsterdam.
countryCode	string	Code pays iso 3166-1 alpha-3 à 3 caractères. Par exemple, les États-Unis.
drivingSide	DrivingSide	Indique la conduite côté gauche par rapport à droite au point de la manœuvre.
exitNumber	string	Nombre(s) d’une sortie d’autoroute prise par la manœuvre actuelle. Si une sortie a plusieurs numéros de sortie, ils sont séparés par « », et éventuellement agrégés par « - », par exemple, « 10, 13-15 ».
instructionType	GuidanceInstructionType	Type de l’instruction, par exemple, virage ou changement de formulaire de route.
junctionType	JunctionType	Type de la jonction où la manœuvre a lieu. Pour les grands ronds-points, deux instructions distinctes sont générées pour entrer et sortir du rond-point.
maneuver	GuidanceManeuver	Code identifiant la manœuvre.
message	string	Un message lisible par l’homme pour la manœuvre.
point	LatLongPair	Emplacement représenté sous la forme d’une latitude et d’une longitude.
pointIndex	integer	Index du point dans la liste des « points » polylignes correspondant au point de l’instruction.
possibleCombineWithNext	boolean	Il est possible de combiner éventuellement l’instruction avec la suivante. Cela peut être utilisé pour générer des messages tels que « Tourner à gauche, puis tourner à droite ».
roadNumbers	string[]	Numéro(s) de route du ou des segments de route significatifs suivants après la manœuvre, ou des routes à suivre. Exemple : ["E34 », « N205"]
roundaboutExitNumber	string	Cela indique la sortie à prendre à un rond-point.
routeOffsetInMeters	integer	Distance entre le début de l’itinéraire et le point de l’instruction.
signpostText	string	Texte sur un panneau qui est le plus pertinent pour la manœuvre, ou pour la direction à suivre.
stateCode	string	Subdivision (par exemple, état) du pays, représentée par la deuxième partie d’un code ISO 3166-2 . Cette option n’est disponible que pour certains pays/régions comme les États-Unis, le Canada et le Mexique.
street	string	Nom de la rue du prochain segment de route significatif après la manœuvre, ou de la rue à suivre.
travelTimeInSeconds	integer	Temps de trajet estimé jusqu’au point correspondant à routeOffsetInMeters.
turnAngleInDecimalDegrees	integer	Indique la direction d’une instruction. Si junctionType indique une instruction de tour : 180 = demi-tour [-179, -1] = Tourner à gauche 0 = Droit sur (un virage '0 degré') [1, 179] = Tourner à droite Si junctionType indique une instruction de bifurcation : <0 - conserver à gauche >0 - conserver la droite

RouteInstructionGroup

Groupes une séquence d’éléments d’instruction qui sont liés les uns aux autres. La plage de séquences est limitée par firstInstructionIndex et lastInstructionIndex. Lorsque des messages texte lisibles par l’homme sont demandés pour obtenir des conseils (instructionType=text ou tagged), un message de synthèse est retourné au groupe d’instructions lorsqu’il est disponible.

Nom	Type	Description
firstInstructionIndex	integer	Index de la première instruction des instructions et appartenant à ce groupe.
groupLengthInMeters	integer	Longueur du groupe.
groupMessage	string	Message de résumé lorsque des messages texte lisibles par l’homme sont demandés pour obtenir des conseils (instructionType=text ou étiqueté).
lastInstructionIndex	integer	Index de la dernière instruction des instructions et appartenant à ce groupe.

RouteInstructionsType

Si elle est spécifiée, des instructions d’aide sont retournées. Notez que le paramètre instructionsType ne peut pas être utilisé conjointement avec routeRepresentation=none

Nom	Type	Description
coded	string	Retourne des données d’instructions brutes sans messages lisibles par l’homme.
tagged	string	Retourne des données d’instruction brutes avec des messages étiquetés lisibles par l’homme pour permettre la mise en forme. Un message lisible par l’homme est créé à partir d’éléments identifiés reproductibles. Celles-ci sont étiquetées pour permettre aux applications clientes de les mettre en forme correctement. Les composants de message suivants sont marqués quand instructionsType=tagged : street, roadNumber, signpostText, exitNumber, rond-pointExitNumber. Exemple de message étiqueté « Tourner à gauche » : Turn left onto <roadNumber>A4</roadNumber>/<roadNumber>E19</roadNumber> towards <signpostText>Den Haag</signpostText>
text	string	Retourne des données d’instructions brutes avec des messages lisibles par l’homme en texte brut.

RouteLeg

Description d’une partie d’un itinéraire, composée d’une liste de points. Chaque point de chemin supplémentaire fourni dans la demande entraîne une étape supplémentaire dans l’itinéraire retourné.

Nom	Type	Description
points	LatLongPair[]	Tableau de points
summary	RouteLegSummary	Objet récapitulative pour la section route.

RouteLegSummary

Objet récapitulative pour la section route.

Nom	Type	Description
arrivalTime	string	Heure d’arrivée estimée pour l’itinéraire ou l’étape. L’heure est à l’échelle de temps UTC.
batteryConsumptionInkWh	number	Estimation de la consommation d’énergie électrique en kilowattheures (kWh) à l’aide du modèle de consommation électrique. Inclus si vehicleEngineType est défini sur électrique et constantSpeedConsumptionInkWhPerHundredkm est spécifié. La valeur de batteryConsumptionInkWh inclut l’énergie électrique récupérée et peut donc être négative (ce qui indique la prise d’énergie). Si maxChargeInkWh et currentChargeInkWh sont spécifiés, la récupération sera limitée pour garantir que le niveau de charge de la batterie ne dépasse jamais maxChargeInkWh. Si ni maxChargeInkWh ni currentChargeInkWh ne sont spécifiés, la récupération sans contrainte est supposée dans le calcul de la consommation.
departureTime	string	Heure de départ estimée de l’itinéraire ou de l’étape. L’heure est à l’échelle de temps UTC.
fuelConsumptionInLiters	number	Estimation de la consommation de carburant en litres à l’aide du modèle de consommation de combustion. Inclus si vehicleEngineType est défini sur combustion et constantSpeedConsumptionInLitersPerHundredkm est spécifié. La valeur n’est pas négative.
historicTrafficTravelTimeInSeconds	integer	Temps de trajet estimé calculé à l’aide de données de trafic historique dépendantes du temps. Inclus uniquement si computeTravelTimeFor = all est utilisé dans la requête.
lengthInMeters	integer	Propriété Length In Meters
liveTrafficIncidentsTravelTimeInSeconds	integer	Temps de trajet estimé calculé à l’aide de données de vitesse en temps réel. Inclus uniquement si computeTravelTimeFor = all est utilisé dans la requête.
noTrafficTravelTimeInSeconds	integer	Temps de trajet estimé calculé comme s’il n’y avait pas de retards sur l’itinéraire en raison des conditions de circulation (par exemple, la congestion). Inclus uniquement si computeTravelTimeFor = all est utilisé dans la requête.
trafficDelayInSeconds	integer	Délai estimé en secondes provoqué par le ou les incidents en temps réel en fonction des informations sur le trafic. Pour les itinéraires planifiés avec l’heure de départ à l’avenir, les retards sont toujours de 0. Pour retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur le trafic, le paramètre computeTravelTimeFor=all doit être ajouté.
travelTimeInSeconds	integer	Durée de trajet estimée en secondes, propriété qui inclut le retard dû au trafic en temps réel. Notez que même lorsque traffic=false travelTimeInSeconds inclut toujours le retard dû au trafic. Si DepartAt est à l’avenir, le temps de trajet est calculé à l’aide de données de trafic historique dépendantes du temps.

RouteOptimizedWaypoint

Objet point de chemin optimisé.

Nom	Type	Description
optimizedIndex	integer	Index de point de voie optimisé à partir du système.
providedIndex	integer	Index de point de chemin fourni par l’utilisateur.

RouteReport

Indique les paramètres effectifs utilisés dans l’appel actuel.

Nom	Type	Description
effectiveSettings	EffectiveSetting[]	Paramètres ou données effectifs utilisés lors de l’appel de cette API de route.

RouteRepresentationForBestOrder

Spécifie la représentation de l’ensemble d’itinéraires fourni en tant que réponse. Cette valeur de paramètre ne peut être utilisée qu’avec computeBestOrder=true.

Nom	Type	Description
none	string	Inclut uniquement les index de point de route optimisés, mais n’inclut pas la géométrie d’itinéraire dans la réponse.
polyline	string	Inclut la géométrie de routage dans la réponse.
summaryOnly	string	Résumé conformément à la polyligne, mais à l’exclusion des éléments géométriques de point pour les itinéraires dans la réponse.

RouteSection

Les sections de routage contiennent des informations supplémentaires sur les parties d’un itinéraire. Chaque section contient au moins les éléments startPointIndex, endPointIndexet sectionType.

Nom	Type	Description
delayInSeconds	integer	Retard en secondes provoqué par l’incident.
effectiveSpeedInKmh	integer	Vitesse effective de l’incident en km/h, moyenne sur toute sa longueur.
endPointIndex	integer	Index du dernier point (décalage 0) dans la route à laquelle cette section s’applique.
magnitudeOfDelay	DelayMagnitude	Ampleur du délai causé par l’incident. Ces valeurs correspondent aux valeurs du champ de réponse ty de l’API Obtenir le détail des incidents de trafic.
sectionType	ResponseSectionType	Types de section de la réponse de routage signalée
simpleCategory	SimpleCategory	Type de l’incident. Actuellement, il peut s’agir de JAM, ROAD_WORK, ROAD_CLOSURE ou AUTRE. Pour plus d’informations, consultez « tec ».
startPointIndex	integer	Index du premier point (décalage 0) dans l’itinéraire auquel cette section s’applique.
tec	RouteSectionTec	Détails de l’événement de trafic, à l’aide de définitions dans la norme TPEG2-TEC . Peut contenir des éléments effectCode et causes.
travelMode	ResponseTravelMode	Mode voyage pour l’itinéraire calculé. La valeur est définie other sur si le mode de transport demandé n’est pas possible dans cette section

RouteSectionTec

Détails de l’événement de trafic, à l’aide de définitions dans la norme TPEG2-TEC . Peut contenir des éléments effectCode et causes.

Nom	Type	Description
causes	RouteSectionTecCause[]	Tableau de causes
effectCode	integer	Effet sur le flux de trafic. Contient une valeur dans la table tec001 :EffectCode, telle que définie dans la norme TPEG2-TEC . Peut être utilisé pour colorer les événements de trafic en fonction de la gravité.

RouteSectionTecCause

Cause de l’événement de trafic. Peut contenir des éléments mainCauseCode et subCauseCode. Peut être utilisé pour définir l’iconographie et les descriptions.

Nom	Type	Description
mainCauseCode	integer	Main cause de l’événement de trafic. Contient une valeur dans la table tec002 :CauseCode, telle que définie dans la norme TPEG2-TEC .
subCauseCode	integer	Sous-utilisation de l’événement de trafic. Contient une valeur dans la table de sous-cause définie par mainCauseCode, comme défini dans la norme TPEG2-TEC .

RouteSummary

Objet Summary

Nom	Type	Description
arrivalTime	string	Heure d’arrivée estimée pour l’itinéraire ou l’étape. L’heure est à l’échelle de temps UTC.
departureTime	string	Heure de départ estimée de l’itinéraire ou de l’étape. L’heure est à l’échelle de temps UTC.
lengthInMeters	integer	Propriété Length In Meters
trafficDelayInSeconds	integer	Délai estimé en secondes provoqué par le ou les incidents en temps réel en fonction des informations sur le trafic. Pour les itinéraires planifiés avec l’heure de départ à l’avenir, les retards sont toujours de 0. Pour retourner des temps de trajet supplémentaires à l’aide de différents types d’informations sur le trafic, le paramètre computeTravelTimeFor=all doit être ajouté.
travelTimeInSeconds	integer	Durée de trajet estimée en secondes, propriété qui inclut le retard dû au trafic en temps réel. Notez que même lorsque traffic=false travelTimeInSeconds inclut toujours le retard dû au trafic. Si DepartAt est à l’avenir, le temps de trajet est calculé à l’aide de données de trafic historique dépendantes du temps.

RouteType

Type d’itinéraire demandé.

Nom	Type	Description
eco	string	Un itinéraire équilibré par l’économie et la vitesse.
fastest	string	L’itinéraire le plus rapide.
shortest	string	Itinéraire le plus court par distance.
thrilling	string	Comprend des routes intéressantes ou difficiles et utilise aussi peu d’autoroutes que possible. Vous pouvez choisir le niveau de virages inclus et aussi le degré de colline. Consultez les paramètres de colline et d’enroulement pour savoir comment le définir. Il y a une limite de 900 km sur les itinéraires planifiés avec routeType=palpitant

SectionType

Spécifie les types de section signalés dans la réponse d’itinéraire.

Par exemple, si sectionType = piéton, les sections qui conviennent uniquement aux piétons sont retournées. Plusieurs types peuvent être utilisés. Le sectionType par défaut fait référence à l’entrée travelMode. Par défaut, travelMode est défini sur car

Nom	Type	Description
carTrain	string	Sections de l’itinéraire qui sont des voitures ou des trains.
carpool	string	Sections de l’itinéraire qui nécessitent l’utilisation de voies de covoiturage (HOV/Véhicule à occupation élevée).
country	string	Sections indiquant les pays/régions dans lesquels se trouve l’itinéraire.
ferry	string	Sections de l’itinéraire qui sont des traversiers.
motorway	string	Sections de l’itinéraire qui sont des autoroutes.
pedestrian	string	Sections de l’itinéraire qui ne conviennent qu’aux piétons.
tollRoad	string	Sections de l’itinéraire qui nécessitent le paiement d’un péage.
tollVignette	string	Sections de l’itinéraire qui nécessitent la présence d’une vignette de péage.
traffic	string	Sections de l’itinéraire qui contiennent des informations sur le trafic.
travelMode	string	Sections par rapport au paramètre travelModede requête .
tunnel	string	Sections de l’itinéraire qui sont des tunnels.
urban	string	Sections de l’itinéraire situées dans des zones urbaines.

SimpleCategory

Type de l’incident. Actuellement, il peut s’agir de JAM, ROAD_WORK, ROAD_CLOSURE ou AUTRE. Pour plus d’informations, consultez « tec ».

Nom	Type	Description
JAM	string	Embouteillage.
OTHER	string	Autre.
ROAD_CLOSURE	string	Fermeture de la route.
ROAD_WORK	string	Travaux routiers.

TravelMode

Mode de déplacement pour l’itinéraire demandé. Si elle n’est pas définie, la valeur par défaut est « car ». Notez que le travelMode demandé peut ne pas être disponible pour l’ensemble de l’itinéraire. Si le travelMode demandé n’est pas disponible pour une section particulière, l’élément travelMode de la réponse pour cette section sera « other ». Notez que les modes de voyage bus, moto, taxi et fourgonnette sont des fonctionnalités BÊTA. Les données de restriction complètes ne sont pas disponibles dans toutes les zones.

Nom	Type	Description
bicycle	string	Les itinéraires retournés sont optimisés pour les vélos, y compris l’utilisation de pistes cyclables.
bus	string	Les itinéraires retournés sont optimisés pour les autobus, y compris l’utilisation de voies réservées aux autobus. Fonctionnalité BÊTA.
car	string	Les itinéraires retournés sont optimisés pour les voitures.
motorcycle	string	Les itinéraires retournés sont optimisés pour les motocyclettes. Fonctionnalité BÊTA.
pedestrian	string	Les itinéraires retournés sont optimisés pour les piétons, y compris l’utilisation des trottoirs.
taxi	string	Les itinéraires retournés sont optimisés pour les taxis. Fonctionnalité BÊTA.
truck	string	Les itinéraires retournés sont optimisés pour les véhicules commerciaux, comme pour les camions.
van	string	Les itinéraires retournés sont optimisés pour les fourgonnettes. Fonctionnalité BÊTA.

VehicleEngineType

Type de moteur du véhicule. Lorsqu’un modèle de consommation détaillé est spécifié, il doit être cohérent avec la valeur de vehicleEngineType.

Nom	Type	Description
combustion	string	Moteur à combustion interne.
electric	string	Moteur électrique.

VehicleLoadType

Types de cargaisons qui peuvent être classées comme des matières dangereuses et interdites à partir de certaines routes. Les valeurs vehicleLoadType disponibles sont les classes US Hazmat 1 à 9, ainsi que les classifications génériques à utiliser dans d’autres pays/régions. Les valeurs commençant par USHazmat sont destinées au routage des États-Unis, tandis que otherHazmat doit être utilisé pour tous les autres pays/régions. vehicleLoadType peut être spécifié plusieurs fois. Ce paramètre est actuellement pris en compte uniquement pour travelMode=truck.

Nom	Type	Description
USHazmatClass1	string	Explosifs
USHazmatClass2	string	Gaz compressé
USHazmatClass3	string	Liquides inflammables
USHazmatClass4	string	Matières solides inflammables
USHazmatClass5	string	Oxydants
USHazmatClass6	string	Poisons
USHazmatClass7	string	Matières radioactives
USHazmatClass8	string	Substances corrosives
USHazmatClass9	string	Divers
otherHazmatExplosive	string	Explosifs
otherHazmatGeneral	string	Divers
otherHazmatHarmfulToWater	string	Nocif pour l’eau

WindingnessLevel

Niveau de virages pour un itinéraire palpitant. Ce paramètre ne peut être utilisé qu’avec routeType=thrilling.

Nom	Type	Description
high	string	high
low	string	low
normal	string	normal