Documentation technique

Accueil / Documentation technique / Flux v2 / API métadonnées / Exploiter ou fournir la métadonnée Tripadvisor

Exploiter ou fournir la métadonnée Tripadvisor

Exploiter les données Tripadvisor

Les métadonnées tripadvisor sont injectées par les acteurs du réseau Apidae, sur la base du volontariat, et dans l’intérêt de tous. Avant toute exploitation, il vous appartient de vérifier si la donnée est disponible sur votre territoire et par quels fournisseurs. Si la donnée n’est pas présente ou est lacunaire, participez en offrant vos services à un fournisseur existant (en lui proposant vos correspondances) ou en devenant vous-même fournisseur. En cas de doute, contactez-nous !

Tripadvisor fournit des API qui peuvent être intéressantes à exploiter dans vos créations. Des fournisseurs injectent l’information permettant d’établir la correspondance entre une fiche Apidae et Tripadvisor, ce qui vous permet d’agrémenter vos sites avec les API Tripadvisor.

En savoir plus
cf. site d’Aide Utilisateurs – Exploiter les informations issues de TripAdvisor sur son site

Trouver et exploiter la métadonnée Tripadvisor sur une fiche

Sur un objet touristique au format v2, le champ metadonnees (facultatif) liste l’ensemble des métadonnées disponible sur l’objet :

"metadonnees" : [ {
    "noeudId" : "tripadvisor-adaka",
    "contenus" : [ {
      "cible" : "general",
      "metadonnee" : {
        "locationId" : "1893513",
        "version" : 1
      }
    } ]
  } ]

Il existe potentiellement plusieurs fournisseurs de la donnée Tripadvisor, donc plusieurs noms de noeuds associées à cette métadonnée. Pour extraire cette donnée, il vous faut donc dans le champ métadonnées chercher les noeuds nommés tripadvisor-*, * étant un nom de fournisseur quelconque. Une fois le ou les noeuds sélectionnés, le champ contenus indique les données associées :

"contenus" : [ {
      "cible" : "general",
      "metadonnee" : {
        "locationId" : "1893513",
        "version" : 1
      }
    } ]

Une fois le noeud récupéré, dans la section nommée general, vous trouverez un champ locationId ; dans notre exemple « 1893513 ». Le champ version est spécifique à la métadonnée tripadvisor et a été prévu au cas où il serait nécessaire de faire évoluer le format pour indiquer d’autres informations.

Le champ locationId vous permet de construire une iframe avec les informations tripadvisor désirées.

Exemple de widget pour ajouter un avis :

[iframe src="https://www.tripadvisor.fr/WidgetEmbed-ssnarrowcollectreview?locationId=2354263&lang=fr_FR&format=inner&display=true&display_version=2&border=true" width="500" height="500"][/iframe]

Exemple de widget pour les extraits d’avis :

[iframe src="https://www.tripadvisor.fr/WidgetEmbed-selfserveprop?locationId=1893513&lang=fr_FR&format=inner&display=true&display_version=2&border=true" width="250" height="200"][/iframe]

En indiquant un locationId dans l’url suivante http://www.tripadvisor.fr/Widgets-g187110-d1893513.html, vous obtiendrez une page qui décrit l’ensemble des widgets disponibles et leurs paramètres d’inclusion.

Liste des fournisseurs / couverture géographique

  • Adaka – Auvergne, Rhône-Alpes, PACA, Ile de France, Tarn
  • Vous souhaitez fournir des données, manifestez-vous !

A ce jour le nœud à utiliser est donc « tripadvisor-adaka »

Devenir fournisseur de données Tripadvisor

Vous possédez ou souhaitez établir une base de correspondance tripadvisor et Apidae ? Vous pouvez devenir fournisseur de données tripadvisor. Ceci vous permet de :

  • valoriser votre savoir-faire auprès du réseau ;
  • valoriser votre travail auprès de votre commanditaire (office de tourisme, …) en assurant la diffusion de données liées à son offre ;
  • retrouver ces données sur vos différents projets (puisque les métadonnées sont enregistrées dans Apidae)

Pour devenir fournisseur de métadonnées tripadvisor, nous vous demandons :

  • De vous manifester auprès du réseau Apidae en nous précisant votre cadre d’action (couverture géographique, commanditaire, …)
  • De consulter sur github notre projet apidae-metadata-tripadvisor qui propose une documentation et des scripts qui peuvent vous assister dans votre démarche