Plus de données et de statistiques - utilisation de l'API Telraam
Certaines données produites par Telraam ne sont pas directement disponibles sur www.telraam.net (ni sur les pages standard du site, ni via les tableaux de bord personnels et de réseau). Cependant, comme tout autre produit de données, elles sont également accessibles via l'API (Application Programming Interface) Telraam. Vous trouverez toutes les informations nécessaires via le lien suivant: Telraam API.
La dernière version de l'API Telraam (version 1.2) a été lancée en février 2021.
Comment accéder à l'API ?
L'API fonctionne avec des jetons (token) pour gérer la charge et contrôler les autorisations d'accès à des produits de données spécifiques sur nos serveurs. Un jeton de base peut être obtenu gratuitement via le tableau de bord de votre compte Telraam. (Vous pouvez toujours créer un compte Telraam même sans posséder de Telraam !) Dans la barre de menu à gauche, cliquez sur la section "Token" sous "API", puis vous pouvez demander votre token personnel en cliquant sur le bouton en haut à droite de l'écran.
Comment travailler avec l'API ?
D'après notre expérience, la plupart des gens sont principalement intéressés par le téléchargement des données présentées sur la page web de chaque segment de route spécifique, afin de pouvoir jouer avec les chiffres eux-mêmes. Dans cet exemple, voici comment vous pouvez utiliser l'API :
Téléchargez et installez l'application Postman (il s'agit d'une application simple, gratuite et multiplateforme permettant de développer et d'utiliser des appels d'API) à l'adresse suivante : https://www.getpostman.com/.
Ouvrez Postman et, dans l'espace de travail vide, cliquez sur l'onglet "+" (à gauche de l'onglet "...").
Effectuez un appel POST (changez GET en POST devant le champ de saisie vide), puis écrivez l'URL de l'appel API sélectionné (dans notre cas, l'appel "Traffic API") dans le champ de saisie sous la forme suivante : "https://telraam-api.net/v1/reports/traffic" (sans les guillemets).Sous l'adresse, cliquez sur l'onglet "Headers" et dans le champ "Key", écrivez "X-Api-Key". Saisissez ensuite votre jeton API personnel dans le champ "Value". Si elles ne sont pas encore présentes par défaut, assurez-vous que les entrées "Content-Type" et "application/json" sont également ajoutées de manière similaire. Après cette étape, votre fenêtre postman devrait ressembler à ceci (mais avec votre jeton d'API)
Enfin, vous pouvez spécifier les paramètres de votre requête API dans l'onglet "Body" (à côté de l'onglet "Headers"). Ici, en suivant le format spécifié ci-dessous, vous pouvez saisir l'identifiant du segment qui vous intéresse (dans le champ "id", où l'identifiant - ou ID du segment - peut être trouvé dans l'adresse web de chaque segment sur le site web de Telraam, par exemple, https://telraam.net/fr/location/347295/2019-11-26/2019-12-10 -> l'ID du segment est alors 347295), et la date et l'heure de début et de fin (en UTC / Temps Universel Coordonné) de l'intervalle qui vous intéresse (maximum 1 an à la fois). Assurez-vous que "raw" est sélectionné comme format au-dessus du champ de saisie.
Ensuite, en cliquant sur le gros bouton bleu "Send", vous pouvez envoyer votre demande. En fonction de la quantité de données présentes sur le serveur Telraam pour la période demandée, vous recevrez en quelques secondes une réponse contenant les données.
Pour bien comprendre tous les champs de données renvoyés, veuillez consulter la version complète de la documentation API disponible via le lien suivant: Telraam API documentation.
Exemple : Données "Vitesse par heure"
C'est une des statistiques qui est souvent demandée par nos utilisateurs.
Via le site web, via le tableau de bord, et via l'excel dans votre tableau de bord vous ne pouvez pas voir les données par heure.
Cela n'est possible que via l'API avec la méthode POST traffic. Vous recevrez alors une réponse comprenant car_speed_hist_0to70plus et car_speed_hist_0to120plus. Ces champs contiennent les histogrammes de vitesse avec une résolution de 5 km/h et 10 km/h, respectivement. Pour en savoir plus sur cette méthode API, consultez le lien suivant : API Documentation Data "Speed per hour".
