Meer gegevens en statistieken met behulp van de Telraam API
Sommige gegevens die door Telraam worden geproduceerd, zijn niet rechtstreeks beschikbaar op www.telraam.net (noch op de standaardpagina's van de site, noch via de persoonlijke en netwerkdashboards). Deze zijn echter, net als alle andere gegevensproducten, ook toegankelijk via de Telraam API (Application Programming Interface). Je vindt alle nodige informatie via de volgende link: Telraam API.
De nieuwste versie van de Telraam API (versie 1.2) is in februari 2021 live gegaan.
Hoe krijg ik toegang tot de API?
De API werkt met tokens om de belasting te beheren en om de toegangstoestemmingen tot specifieke gegevensproducten op onze servers te regelen. Een basistoken kan gratis worden verkregen via het dashboard van uw Telraam-account. (Je kunt altijd een Telraam account aanmaken, zelfs zonder Telraam te bezitten!) Klik in de menubalk aan de linkerkant op de sectie "Token" onder "API", vervolgens kunt u uw persoonlijke token aanvragen door rechtsboven op het scherm op de knop te klikken.
Hoe werken met de API?
Onze ervaring is dat de meeste mensen vooral geïnteresseerd zijn in het downloaden van de gegevens die op de webpagina van elk specifiek wegsegment worden gepresenteerd, zodat ze zelf met de cijfers kunnen spelen. Als we dit voorbeeld nemen, is dit hoe je het zou doen met behulp van de API:
Download en installeer de Postman app (het is een eenvoudige, gratis, cross-platform app voor het ontwikkelen en gebruiken van API-oproepen) van: https://www.getpostman.com/
Open Postman, en in de lege werkruimte, klik op de "+" tab (links van de "..." tab)
Doe een POST oproep (verander GET in POST voor het lege invoerveld), en schrijf dan de URL van de geselecteerde API oproep (in ons geval de "Traffic API" oproep) in het invoerveld als: "https://telraam-api.net/v1/reports/traffic" (zonder de aanhalingstekens).
Klik onder het adres op de "Headers" tab en schrijf in het "Key" veld: "X-Api-Key". Voer vervolgens uw persoonlijke API token in het "Value" veld in. Indien nog niet standaard aanwezig, zorg er dan voor dat ook de vermelding "Content-Type" en "application/json" op een soortgelijke manier is toegevoegd. Na deze stap zou je postman venster er als volgt uit moeten zien (maar dan met je API Token):
Tenslotte kun je de parameters van je API verzoek specificeren in het "Body" tabblad (naast het "Headers" tabblad). Hier kun je volgens het hieronder gespecificeerde formaat de identifier van het segment waarin je geïnteresseerd bent invoeren (in het veld "id", waarbij de identifier - of segment ID - te vinden is in het webadres van elk segment op de Telraam website, bijv. https://telraam.net/nl/location/347295/2019-11-26/2019-12-10 -> de segment ID is dan 347295), en de begin- en einddatum en -tijd (in UTC) van het interval waarin je geïnteresseerd bent (maximaal 1 jaar in één keer). Zorg ervoor dat "raw" is geselecteerd als formaat boven het invoerveld.
Door vervolgens op de grote blauwe knop "Verzenden" te klikken, kun je je verzoek verzenden, en afhankelijk van hoeveel gegevens er op de Telraam-server staan voor de door jou gevraagde periode, ontvang je binnen enkele seconden een antwoord met de gegevens. Voor een volledig begrip van alle gegevensvelden, gelieve de volledige Telraam API documentatie.
Voorbeeld: Data "Snelheid per uur"
Dit is één van de datapakketten die vaak door onze gebruikers wordt opgevraagd.
Via de website, via het dashboard, en via de excel in uw dashboard kun je de gegevens per uur niet bekijken.
Dat kan alleen via de API met de POST traffic methode. Je krijgt dan een antwoord met daarin car_speed_hist_0to70plus en car_speed_hist_0to120plus. Deze velden bevatten de snelheidshistogrammen met een resolutie van respectievelijk 5 km/h en 10 km/h. Om meer te weten te komen over deze API-methode, zie de volgende link: API Documentation Data "Speed per hour".
