English text below
-
Die API erlaubt den Zugriff auf die kompletten Daten des Zugmonitors in Echtzeit im JSON-Format.
Es wird nur ein Recht auf nicht-kommerzielle Nutzung der Daten eingeräumt (also z.B. bitte keine kostenpflichtige Android-App damit umsetzen). Die Veröffentlichung dieser Informationen als wirkliches Open Data ist Sache der Deutsche Bahn.
Bitte haltet bei Nutzung der API die Last für unseren Server gering.
Wenn ihr auf Grundlage der Daten veröffentlicht, schickt uns doch bitte einen Link. Und erwähnt als Quelle: Zugmonitor von süddeutsche.de/OpenDataCity
Fragen? Kontakt per info-at-opendatacity-de | Neuigkeiten gibt es bei Twitter @zugmonitor
Dokumentation
Bahnhöfe:
http://zugmonitor.sz.de/api/stations - alle Stationen referenziert über deren IDs
Eigenschaften jeder Station: “name”, koordinaten (“lat”, “lon”) und “id”
Datum/ Alle Züge eines bestimmten Tages:
http://zugmonitor.sz.de/api/trains/DATUM
- z.B. http://zugmonitor.sz.de/api/trains/2012-03-09
Eigenschaften jeden Zuges:
“train_nr”: Zugnummer, z.B. ”IC 2061″
“date”: Datum - stimmt immer mit DATUM in der URL überein. Zählung der Monate startet bei null: 0 = Januar, 1 =Februar etc. (Danke an Stefan K. für den Hinweis)
“status”: Scraper Status
“E” – Error – beim Scrapen ist ein Fehler ausgetreten
“F” – Finished – Zug wurde komplett gescraped
“S” – Sleeping – Zug fährt gerade und Scraping läuft noch
“X” – Running – Zug wird gerade gescrapt
“started”, “nextrun”, “finished” – Start, nächster Lauf und Ende des Scrapens dieses Zuges
“stations”: Stationen des Zuges
“station_id”: ID des Bahnhofes – entspricht den IDs von http://zugmonitor.sz.de/api/stations
“arrival”, “departure” – Ankunft und Abfahrt in Minuten seit 00:00 des jeweiligen Tages – z.B: 860 = 14*60+20 = 14:20h
“delay”: Verspätung der Station in Minuten – falls “delay” nicht gesetzt ist bedeutet das 0 Minuten Verspätung.
“delay_cause”: Verspätungsursache
“scraped”: Zug wurde zwischen dieser Station und der nächsten gescrapt
— Ende
ENGLISH
The API gives you access to the complete data of the Rail Monitor in realtime in JSON.
Please use it only for non-commercial applications (e.g. not for an Android app you sell for money). For this you have to wait for German railway to publish its timetable etc. as real Open Data.
Please be kind to our server.
When you use the data, it would be nice to get a link to your work send to us. Please mention the source: suedeutsche.de/OpenDataCity
Questions? Ask us via info-at-opendatacity-de – News @zugmonitor
Documentation
Stations:
http://zugmonitor.sz.de/api/stations - all stationen with IDs
station attributes:
“name”, coordinats (“lat”, “lon”) and “id”
date/ all a trains on a given day:
http://zugmonitor.sz.de/api/trains/DATE
- e.g.. http://zugmonitor.sz.de/api/trains/2012-04-09
Attributes of every train:
“train_nr”: train nummer, e.g. ”IC 2061″
“date”: counts starts every month at zero: 0 = January, 1 =February etc.
“status”: scraper status
“E” – Error – there was an error while scraping
“F” – Finished – train scrape was completed
“S” – Sleeping – train is on the go and scraper is still running
“X” – Running – train is scraped at the moment
“started”, “nextrun”, “finished” – start, next run and end of train-scrape
“stations”: train stops
“station_id”: ID of the station – similar to IDs of http://zugmonitor.sz.de/api/stations
“arrival”, “departure” – in minuts since 00:00 of the given day - e.g: 860 = 14*60+20 = 14:20h
“delay”: at station in minuts – if there is no “delay” = there are 0 min delay
“delay_cause”: cause of delay
“scraped”: train has been scraped between this station and the next
— end
Saier 22 Jun ’12
Frage: Gibt es eine App für Samsung Galaxy?
lorz 30 Jun ’12
Nein. Die könnte aber mittels der API entwickelt werden.
Olaf 16 Jan ’13
Live Verspätungen & Statusmeldungen ICEs als Twitter-Stream unter: https://twitter.com/zugmon
Einfach nach ‘ice1234′ suchen…
Wir kämpfen derzeit mit dem Rate-Limitting von Twitter, daher werden mehrere Meldungen in einen Tweet zusammengefasst.
lorz 17 Jan ’13
Klasse. Toll wäre noch ein Link auf die jeweilige Verbindung beim Zugmonitor.
Olaf 17 Jan ’13
@lorz: Kommt als nächstes. Problem immer noch das Rate Limit bei Twitter. Derzeit komprimieren wir mehrere Reports in einen Tweet um im Limit zu bleiben. Wenn da Urls dazukommen, werden das wieder mehr Tweets und wir reißen das Limit wieder. Außerdem gehen im Moment nur ICE – auch wegen dem Limit. Insofern mal schauen, was da geht.
stefan 28 Jan ’13
Wie aktuell sind denn die Daten?
Gruss,
Stefan
lorz 28 Jan ’13
falls die frage ernst gemeint ist (weil oben steht ja “echtzeit”) die Daten werden von bahn.de geholt und sind max. mit einer min. verzögerung hier über die api abfragbar
stefan 29 Jan ’13
Entschudlgung, vielleicht habe ich mich etwas undeutlich ausgedrückt. Die Frage war, in welchem Abstand die Daten gescrapt werden?
lorz 29 Jan ’13
Der Scraper orientiert sich am Fahrplan. Wenn ein Zug fahrplanmäßig losfahren soll, begleitet der Scraper ihn bis er angekommen ist; es wird mind. alle 60 Sekunden abgefragt, ob auf bahn.de eine Verspätung für den Zug gemeldet wird.
Simon 21 Apr ’13
Hallo,
Kann man die vergangenen Daten als zip herunterladen, oder muss ich das über die API machen?
Ich bin mir am überlegen, ob man nicht ein Online-Prognosetool erstellen könnte (geplant mit shiny.rstudio.org).
Grüße,
Simon
lorz 24 Mai ’13
Nein, kann man nicht als zip herunterladen.
Olaf 16 Mai ’13
So jetzt gibt es die Daten von @ZugMon auch als eigene Mobil-Website: http://zugmon.de. Man braucht also keinen Twitter-Account mehr… Details hier: http://zugmon.de/info