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 l'APIJS

Utilisation du composant de recherche de POIs

Dans cet exemple, nous allons rechercher les POIs (points d'intérêt) aux alentours du point central de Paris et afficher la liste des noms des pois trouvés.

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 la recherche, il faut fournir les coordonnées géographiques sur lesquelles la recherche sera lancée. Cela se fait avec la propriété "center" de la configuration.

var conf = {
  db : "163978",
  service : ViaMichelin.Api.Constants.Poi.SERVICE_TYPE.FIND_POI,
  center : {
    // Paris
    lon : 2.35107,
    lat : 48.85684
  }
};
		

Réponse du calcul

Une fois la recherche effectuée, le composant propage le résultat via l'événement onSuccess. Le résultat contient une propriété poiList qui est un tableau contenant les objets POIs retournés.

var output = $_id("output");
var callbacks = {
  onSuccess : function (results) {
    var outputHTML, i, item, poi;
    outputHTML = results.poiList.length + " résultats trouvés.";
    for (i = 0; i < results.poiList.length; i++) {
      item = results.poiList[i];
      poi = item.poi;
      outputHTML += "\n- " + poi.name + " (à " + item.dist + "m)";
    }
    output.innerHTML = outputHTML;
  }
};
		

Lancement du calcul

Le composant de recherche de POIs se nomme ViaMichelin.Api.Poi. Il s'utilise avec la méthode VMLaunch et on lui fourni conf etcallbacks.

VMLaunch("ViaMichelin.Api.Poi", 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 recherche de POIs.

Consulter les références du composant.