VIAMICHELIN JAVASCRIPT API


Quickstart

Chargement de l'APIJS

Pour utiliser l'APIJS, il est nécessaire d'ajouter cette balise script dans le head dans votre page, en renseignant votre clé (KEY) et la langue souhaitée (LANG).

<script src="http://apijsv2.viamichelin.com/apijsv2/api/js?key=KEY&lang=LANG" type="text/javascript"> </script>
			

Pour plus d'informations sur KEY et LANG, consulter le chargement de l'APIJS.

 

Utilisation du composant d'Itinéraire

Dans cet exemple, nous allons afficher les informations principales de l'itinéraire que nous venons de calculer.

Le HTML

Nous créons un tag pre pour afficher les données reçues du composant

<pre id="output"></pre>
		

Configuration du composant

Pour lancer le calcul d'itinéraire, il faut fournir les lieux de départ et d'arrivée. Cela se fait avec la propriété steps de la configuration.

var paris = {
  coords : {
    lon : 2.35107,
    lat : 48.85684
  }
};
var bordeaux = {
  coords : {
    lon : -0.57574,
    lat : 44.83498
  }
};
var conf = {
  steps : [
    paris,
    bordeaux
  ]
};
		

Réponse du calcul

Une fois le calcul effectué, le composant propage le résultat via l'événement onSuccess. Le résultat contient une propriété header avec les principales informations de la réponse.

var output = $_id("output");
var callbacks = {
  onSuccess : function (result) {
    iti = result.header.summaries[0];
    var t = iti.totalTime,
      h = Math.floor(t / 3600),
      m = Math.floor(t % 3600 / 60),
      report = "";
    report +=   "Distance : " + iti.totalDist / 1000 + "km";
    report += "\nDurée    : " + h + "h " + m + "min";
    report += "\nCoût     : " + iti.tollCost.car / 100 + "€";
    output.innerHTML = report;
  }
};
		

Lancement du calcul

Le composant de calcul d'itinéraire se nomme ViaMichelin.Api.Itinerary. Il s'utilise avec la méthode VMLaunch et on lui attribue les paramètres conf et callbacks.

VMLaunch("ViaMichelin.Api.Itinerary", conf, callbacks);
		

Démonstration

Si vous souhaitez voir le résultat de ce guide, consultez la page de démonstration.

Aller plus loin

Voir d'autres exemples de l'utilisation du composant de calcul d'itinéraire.

Consulter les références du composant.