VIAMICHELIN REST API


route

Description

La fonction de calcul d'itinéraire permet d'obtenir les informations nécessaires pour se déplacer sur le réseau routier (feuille de route, trace, coûts) en passant par les points spécifiés en paramètre.

URL

http://apir.viamichelin.com/apir/1/route.{output}/{lg}[/{data}]?steps={dep};[{steps};]{arr}&veht={veht}&itit={itit}&favMotorways={favMotorways}&avoidBorders={avoidBorders}&avoidTolls={avoidTolls}&avoidCCZ={avoidCCZ}&avoidORC={avoidORC}&multipleIti={multipleIti}&itiIdx={itiIdx}&distUnit={distUnit}&fuelConsump={fuelConsump}&fuelCost={fuelCost}&date={date}¤cy={currency}&authkey={authkey}&charset={charset}&ie={ie}&callback={callback}&signature={signature}

Format de sortie

xml, json

Comptabilisation

Un calcul d'itinéraire = une requête facturée (quel que soit le nombre d'étapes et les informations demandées)

Versions du service

VersionDescription
1.0 Ajouté à l'API REST

 

Paramètres d'entrée

NomObligatoire?TypeDescriptionDéfaut
lg oui string Code langue (fra, deu, spa, ita, eng, ces, dan, nld, fin, int, nor, pol, por, swe) N/A
steps oui (1=xy | 2=poiid | 3=locid):('e'=étape classique | 'p'=point de passage):( lon:lat |db:poiid | locid) Liste des étapes. Chaque étape est structurée et constituée de 3 informations: son mode de spécification de l'étape, le type d'étape, ses informations descriptives.
Les étapes sonts séparées par ';'
N/A
data non (header | roadsheet | geom | map) type de ressource que l'on désire obtenir. Si non spécifié, on retournera toutes les données relatives à un itinéraire.
header: l'entête de la feuille de route de l'itinéraire.
roadsheet: la feuille de route de l'itinéraire.
map: la carte représentant l'itinéraire.
geom: la géométrie de l'itinéraire.
vide
veht non 0:Voiture | 1:Camion | 2: Piéton | 3: Vélo | 4:Moto Type de véhicule utilisé pour le calcul d'itinéraire. 'Voiture
wCaravan non bool Spécifie si le calcul doit prendre en compte la présence d'une caravane. Ce paramètre a une influence sur le coût du péage. false
itit non 0:Conseillé par Michelin | 1:Plus rapide | 2:Plus court | 3:Découverte | 4:Economique Type d'itinéraire à calculer.
Conseillé: favorise la sécurité, la simplicité et minimise les risques d'erreur de parcours.
Plus rapide prend le moins de temps pour se rendre à: sa destination. Cet itinéraire favorise les grands axes, notamment les autoroutes.
Plus court pour lequel la distance pour se rendre à son point de destination est la plus courte, tout en restant sur des routes praticables. Cet itinéraire est souvent très long en terme de durée.
Découverte favorise les routes pittoresques présentant un intérêt touristique.
Economique propose une route qui optimise la consommation en carburant et évite de passer par des routes à péages.
Conseillé par Michelin
favMotorways non bool Spécifie si le calcul doit favoriser les autoroutes. false
avoidBorders non bool Spécifie si le calcul doit éviter les passages de frontières. false
avoidTolls non bool Spécifie si le calcul doit éviter les péages. false
avoidCCZ non bool Spécifie si le calcul doit éviter zones payantes (Congestion Charge Zones). false
avoidORC non bool Spécifie si le calcul doit éviter les zones non routières comme les ferrys ou le ferroutage (Off-Road Connections). false
multipleIti non bool Spécifie si l'on souhaite obtenir les itinéraires alternatifs si ils existent. Si data est vide ou vaut header, l'ensemble des résumés des itinéraires est disponibles dans la section header . Voir aussi le paramètre itiIdx. false
itiIdx non positive integer index de l'itinéraire pour lequel on souhaite obtenir les données. N'a de sens que si multipleIti vaut true et data vaut roadsheet, map ou geom. 0
distUnit non m | mi Unité de distance utilisée dans la réponse. m
fuelConsump non positive float:positive float:positive float Indication de la consommation du véhicule en litre au 100km. L'information sera spécifiée de la manière suivante : consommation moyenne à 50km/h:consommation moyenne à 90 km/h:consommation moyenne à 120 km/h. 7.9;6.9;7.0
fuelCost non positive float Coût du carburant (le choix de la monnaie est implicite). 1.3
date non aaaa-mm-jj Date de départ de l'itinéraire. Cela permet de tenir compte de l'ouverture ou fermeture de routes (cols, etc). date du jour
currency non string Monnaie utilisée pour obtenir le coût des péages. Les monnaies prises en charge sont EUR, CHF, CZK, DKK, GBP, HRK, HUF, NOK, PLN, SEK, SIT, SKK, UAH et USD. EUR
ecoTax non boolean Permet d'obtenir le calcul de l'écotaxe.
N'a de sens que si veht vaut 1 et truckOpts est défini
false
truckOpts oui si ecoTax est à true {axles : int, width : int, height : int, weight : int, category : int, euroStandard : int}

axels: nombre d'essieux(6,8, ...)
width: la largeur en dixièmes de mètres
height: la hauteur en dixième de mètres
weight: Poids en dixième de tonne.
category: 
   0 : toute catégorie de véhicule
   4 : transport en commun
   5 : transport de marchandise
   6 : transport de produits explosifs
   7 : transport de produits polluants
   8 : transport de produits dangereux  
euroStandard: Norme européenne d’émission

NB:

- Seuls le nombre d’essieux et le poids (axels & weight) ont une influence sur le calcul de l’Ecotaxe.
- Il faut laisser comme valeur par défaut « 0 » aux sous paramètres category et euroStandard de truckOpts


vide
distanceByCountry non boolean Permet d'avoir le calcul de la distance par pays false
authkey oui string Clef d'authentification. Cela peut-être une clef JS, un token généré par la fonction token ou l'identifiant du client en cas de signature de la requête (voir le paramètre signature) N/A
signature non string Signature de la requête avec l'algorithme HMAC-SHA1 où la clef secrète est le mot de passe du client. Si la requête est signée, authKey doit contenir l'identifiant du client, et expires doit-être valorisé. La signature s'applique sur des URL ayant leurs chaînes de caractères encodées. vide
expires non sauf si signature défini date Date GMT d'expiration de la requête au format yyyy-MM-dd'T'HH:mm:ss.SSS`'Z. vide
callback oui si json string Nom de la fonction de callback à lancer (n'a de sens que si le format vaut json) vide
charset non string Encodage des caractères dans la réponse 'ISO-8859-1'
ie non string Encodage des caractères dans la requête 'ISO-8859-1'

 

Restrictions

  • La disponibilité du calcul d'itinéraire est variable d'un pays à l'autre. ViaMichelin améliore continuellement cette couverture.
  • Le nombre d'étapes est techniquement plafonné à 8 en incluant les points de départ et d'arrivée.
  • Les itinéraire à pied sont plafonnés à 50km et ceux à vélo à 200km.

 

Exemples de requêtes

 

Structure de la réponse

  • La structure est de type iti open in new tab
  •  

Veuillez noter que les champs retournés qui ne seraient pas expliqués dans ce document correspondent à des champs à usage interne de ViaMichelin. Ils peuvent évoluer à tout moment et ne devraient pas être utilisés. Leur présence traduit le fait que ViaMichelin utilise en interne les mêmes services et la même infrastructure que ceux mis à disposition de ces clients.

Retour haut de page