Zum Inhalt springen

Verwendung der CKAN API

CKAN- API

„CKAN ist die führende Softwarelösung, mit der Open Data Portale aufgebaut werden können. CKAN unterstützt die Verwaltung bei der Zentralisierung der Open Data Aktivitäten. Katalogisierung, Versionierung, Speicherung und Protokollierung der veröffentlichten Daten.“

Vorbedingungen für die Verwendung des API

  • Sie sollten wissen, wie JSON zu lesen ist.
  • Sie sollten die Grundprinzipien von REST-APIs verstanden haben.
  • Sie verfügen über einen API-Schüssel aus dem Developer Dashboard.

Weg, um die aktuellste Version einer Ressourcezu finden

Wir verwenden als Beispiel ‚timetable-2016-hrdf‘ (Periodenfahrplan) Mit der Abfrage ‚package_list‘ (siehe unten) können Sie auch die anderen möglichen Datensätze nachschlagen (z.B. ‚bhlist‘).

Sie müssen den Umweg über die Schritte 3 und 4 machen, weil bei jedem Harvesting die Ressource-IDs wechseln. Jede Ressource hat dabei immer eine eindeutige Ressource-ID.

Ablauf:

  1. Verwenden Sie das CKAN-API
  2. Finden Sie den Slug des Datasets (hier ‚timetable-2016-hrdf‘) oder generell nachschlagen mit https://api.opentransportdata.swiss/ckan-api/package_list
  3. Inhalt des Data-Sets auslesen https://api.opentransportdata.swiss/ckan-api/package_show?id=timetable-2016-hrdf
  4. Innerhalb der resources suchen. Es muss der aktuellste Periodic Timetable geladen werden. Die Aktualität lässt sich am Datum feststellen (YYYY-MM-DD) im „url“-Feld.

  • Mit der URL  (‚url‘) können sie die Datei herunterladen
  • Beachten Sie, dass immer ab ca. November der nächste Periodenfahrplan bereitsteht (der Jahresfahrplan schon früher). Andere Datensätze wie Didok bleiben und sind unabhängig vom Fahrplanjahr.

Wichtig zu wissen

Das CKAN-API nicht für sehr starke Belastung ausgelegt: D.h. verwenden sie das CKAN-API nicht als Datawarehouse, sondern für gelegentliche Abfragen und automatisches Identifizieren der Resourcen für den Download.

Andere Metadaten

Über https://api.opentransportdata.swiss/ckan-api/package_show?id=timetable-2016-hrdf erhalten Sie auch alle anderen relevanten Metadaten der Daten.

Im Element resources sind auch die relevanten Angaben zu einer einzelnen Ressource aufgeführt.

Zugriff auf einzelne Datenelemente

Der Zugriff in einzelne Felder wird anhand des Didok-Pseudoservices beschrieben.

 

Weiterführende Angaben

 

 

Diskussion beginnen auf disc.opentransportdata.swiss