Trafikverket Öppet API
Strukturen skiljer sig en hel del från andra APIer på Trafiklab. Hämtning av data görs med ett HTTP-anrop. En fråga skickas med i POST-metoden som beskriver vilket data som efterfrågas samt innehållandes eventuella filter.
Dataformat
XML eller JSON, anges via suffix.
Om något värde saknas i svaret returneras inte detta element i svaret.
API Nyckel
En API nyckel krävs. En API nyckel kan skapas kostnadsfritt i vårt utvecklarportal. Mer information hittas i vår snabbstartsguide.
Metoder
Hämtning av data görs med ett HTTP-anrop. En fråga skickas med i POST-metoden som beskriver vilket data som efterfrågas samt innehållandes eventuella filter. Frågan måste även inkludera en giltig API-nyckel.
Tillgängliga datatyper är:
- TrainMessage - Tågtrafikmeddelande, exempelvis information kring banarbete, tågfel, anläggningsfel och dylikt.
- TrainStation - Trafikplatser, både med och utan resandeutbyte.
- TrainAnnouncement - Tidtabellsinformation, d.v.s information om tåg på trafikplatser (stationer, hållplatser) varje post motsvarar ett visst tåg vid respektive trafikplats.Innehåller inte godståg.
- Icon - Ikoner, exempelvis för användning i grafiska användargränssnitt och kartor.
- RoadCondition – Väglag
- RoadConditionOverview – Väglagsöversikter
- Situation - Situationer innehållandes händelser och störningar, exempelvis: Viktig information, Olyckor, Bärighetsnedsättning, Evenemang, Avvikande färjetider, Kolonnkörning, Kövarning, Oförutsedda hinder, Vägarbete.
- WeatherStation - Väderstationer med mätdata
Koordinatsystem
Trafikverket använder sig av det svenska nationella koordinatsystemet SWEREF 99 TM. All geometridata publiceras dock även i koordinatsystemet WGS 84.
Detaljerad dokumentation
Detaljerad dokumentation hittar du på Trafikverkets informationssida för API:et, se nedan.
Den detaljerade dokumentationen innehåller bland annat information om:
- uppbyggnad av frågan som bifogas anropet
- svarets utformning
- felmeddelanden
- tillgänglig datamodell
- exempelkod och vanliga användningsfall
- en API-konsol för testkörning
Observera att du som är Trafiklabs-medlem inte behöver registrera dig på Trafikverkets sida utan kan hämta en nyckel direkt här på Trafiklab.
För mer information se ” Trafikverkets öppna API för trafikinformation”