API Beschreibungen

Aus OGD Cockpit Bonn
Wechseln zu:Navigation, Suche

Dokumentation Open Data Portal: Wie benutzt man die API des Open Data Portals?

Über das Open Data Portal ist es nicht nur möglich sich Datensätze anzuschauen und herunterzuladen. Man kann ausgewählte Datensätze auch direkt über URL ansprechen und so, programmgesteuert, mit diesen arbeiten. Grundsätzlich funktioniert dies über eine API (Programmierschnittstelle), die lesenden Zugriff auf Portalinhalte ermöglicht. Die Stadt Köln hat eine DKAN API-Beschreibung verfasst, die sich in zwei Blöcke gliedert und deren Möglichkeiten veranschaulicht. Weitere Informationen: http://www.offenedaten-koeln.de/blog/dkan-api-howto

Dokumentation Geodaten: Abruf aller auf http://opendata.bonn.de angebotenen städtischen Geo-JSON APIs

Die GeoJSON-Geodatenbestände der Stadt Bonn stehen als API immer mit dem tagesaktuellen Bearbeitungsstand aus dem Fachverfahren als Open Data zur Verfügung. Alle Änderungen in den städtischen Geobasisdaten werden so automatisch als Open Data und ohne weiteren redaktionellen Aufwand veröffentlicht. Die Erstveröffentlichung erfordert personellen Aufwand und ist zunächst nur als GeoJSON und künftig ggf. als GML möglich. Aus technischen Gründen ist eine direkte API auf die Datenbestände als ShapeFiles derzeit nicht umsetzbar.

Codierung/ Zeichensatz der Standort- und Flächendaten ist Latin-9

Mit dem Parameter "Thema" wird die Identifikationsnummer des Datensatzes adressiert, so z.B die tagesaktuellen Straßenbaustellen mit Thema=14403.

Nach der Spezifikation RFC 7946 https://tools.ietf.org/html/rfc7946 sind im GeoJSON Format künftig nur noch WGS84 Koordinaten erlaubt, welche auf dem Open Data Portal Bonn so verfügbar sind. Für die Nutzung unter Google ist die Einheit der Koordinaten (östliche Länge und nördliche Breite) Dezimalgrad. Die Koordinaten können beim Tausch von Längengrad und Breitengrad in Google gefunden werden.

Einen Überblick der als Open Data verfügbaren GeoJSON finden Sie hier: http://opendata.bonn.de/dataset?f[0]=field_resources%253Afield_format%3A51

Dokumentation Geodaten: Abruf aller auf https://opendata.bonn.de angebotenen Daten der OSM

Lizenzerläuterungen OSM: http://www.openstreetmap.de/faq.html#lizenz

Dokumentation: https://github.com/OKLabBonn/Documentation

Dokumentationen zu den Haushaltsdaten

Beschreibungen Tabellenspalten zu den CSV-Haushaltsplänen

Bei der ersten Spalte (Prctr) handelt es sich um die Angabe des ProfitCenters. Jedes ProfitCenter stellt ein Teilergebnis dar und muss dringend angegeben werden.

Bei den Spalten PSP-Element, Auftrag und Kostenstelle handelt es sich um Kontierungselemente innerhalb jedes ProfitCenters. Sie bestimmen wer funktional, organisatorisch und räumlich mit welcher Kostenart belastet wird.

Die Spalte „GESBE“ zeigt in welchem Geschäftsbereich geplant wurde und die Spalte „Ver“ in welcher Version. Diese Angabe ist wichtig um später Vergleiche zwischen einzelnen Versionen ziehen zu können.

In der Spalte „Text“ wird im Plan beschrieben auf welcher Grundlage die Verrechnung erfolgt. Im IST können hier konkrete Beschreibungen zur Buchung durch das Fachamt eingetragen werden.

Am Ende der CSV sind Zeilen enthalten, die oft Amtsübergreifend sind, und der Betrag wird in der nächsten Zeile mit gleichen Betrag als Minus gegenübergestellt. Hier handelt es sich um Kosten, die zunächst bei einem, zum Teil teilergebnisübergreifenden ProfitCenter geplant wurden und nach einem bestimmten Schlüssel weiter verrechnet werden. In diesem Fall wird dann, dass primär planende ProfitCenter wieder entlastet.

Metadaten zu den CSV-Haushaltsplänen

Eine Hantierungshilfe zu den Metadaten findet sich hier: http://ogdcockpit.bonn.de/index.php/Metadaten_Haushalt_Stadt_Bonn

Für alle Haushaltsjahre gelten die Metadatenbestände:

Profitcenter: http://opendata.bonn.de/dataset/haushalt-profitcenter-metadaten

Finanzpositionen: http://opendata.bonn.de/dataset/haushalt-finanzposititionen-metadaten

Kostenarten: http://opendata.bonn.de/dataset/haushalt-kostenarten-metadaten

Übersicht der Ämter der Stadt Bonn: http://opendata.bonn.de/dataset/%C3%A4mter-der-stadt-bonn

Datenbestand zum Haushalt

Die Haushaltsplandaten werden einmal als Haushaltsplanentwurf (entspricht der Vorlage der Verwaltung zur Beratung durch die Politik) und als Haushaltsplan (entspricht dem von der Politik genehmigten Haushalt) jeweils kalenderjährlich (Haushaltsjahr) veröffentlicht. Die Veröffentlichungen zum Haushalt umfassen:

- Eckdaten des Haushaltes

- Vorbericht zum Haushaltsplan mit Haushaltssicherungskonzept

- Produktplan bestehend aus: NKF Gesamtplan, Produktbereiche, Haushaltspläne der Stadtbezirke, Haushaltssicherungskonzept und Erläuterungsband

- Anlagen mit Wirtschaftslage der Unternehmen und Übersichten

Zu den Haushaltsjahren stehen diese Daten als Open Budget zur Verfügung:

DatensatzNr.JahrFormatDatensatz, Dienst oder Dokument Link
Eckdaten des Haushaltes 2013 2014692013; 2014PDF
Eckdaten des Haushaltes 2015 2016882015; 2016PDF
Eckdaten des Haushaltes 2017 20181982017; 2018PDF
Haushalt Finanzpositionen Metadaten182FortlaufendXLSX
Haushalt Kostenarten Metadaten181FortlaufendXLSX
Haushalt Profitcenter Metadaten183FortlaufendXLSX
Haushaltsplanentwurf 2015 2016872015; 2016CSV
XLSX
PDF
DOC
Haushaltsplanentwurf 2017 20181952017; 2018XLS
Haushaltspläne Finanzplandaten172008; 2009; 2010; 2011; 2012; 2013; 2013; 2015; 2016; 2017; 2018; 2019; 2020; 2021; 2022; 2023; 2024CSV
Haushaltssatzung 2017 20181962017; 2018DOC
Haushaltssicherungskonzept 2015-2024892015; 2016; 2017; 2018; 2019; 2020; 2021; 2022; 2023; 2024PDF
Produktplan NKF Gesamtplan 2013 20141502013; 2014PDF
Produktplan NKF Gesamtplan 2015 20161512015:2016PDF
Produktplan NKF Gesamtplan 2017 20182422017 2018PDF
Produktpläne der Stadtbezirke 2015 20161352015;2016PDF
Produktpläne der Stadtbezirke 2017 20181972017; 2018DOC
Stellenplan 2017 20181992017; 2018DOC
Vorberichte zum Haushaltsplan682013; 2014; 2014; 2015; 2016; 2017; 2018PDF
Zuwendungen an die Ratsfraktionen2012013; 2014; 2014; 2015; 2016; 2017; 2018PDF

Auflistung der Datensätze mit zusätzlicher API Beschreibung

Bonn.de

Die API-Beschreibungen sind bei diesen Datensätzen in dem Feld "Anmerkungen Dokumente" als Datei abrufbar:

Allgemeines zu den Webservices Bonn.de: http://ogdcockpit.bonn.de/images/0/02/API_Dokumentation_Allgemein.rtf

Bürgerbriefe: http://ogdcockpit.bonn.de/index.php/Bürgerbriefe

Pressemeldungen: http://ogdcockpit.bonn.de/index.php/Pressemitteilungen_Bonn

Servicetelefone: http://ogdcockpit.bonn.de/index.php/Servicetelefone

Stadtratsvorlagen: http://ogdcockpit.bonn.de/index.php/Stadtratsvorlagen

Termine der Stadtratsgremien: http://ogdcockpit.bonn.de/index.php/Termine_der_Ratsgremien

Veranstaltungskalender: http://ogdcockpit.bonn.de/index.php/Veranstaltungskalender

Anliegen.Bonn.de

Bürgermeldungen Anliegen.Bonn.de mit Open311: http://anliegen.bonn.de/seiten/Open-Data-mit-Open311

Technische Probleme?

Sollten technische Problem oder weitere Dokumentationswünsche bestehen, so sind wir für einen Hinweis über Twitter https://twitter.com/opendatabonn oder per E-Mail unter opendata@bonn.de dankbar.

Unser Linktipp: Die Stadt Zürich bietet Tipps und Tricks zum Umgang mit Datenformaten hier an: https://www.stadt-zuerich.ch/portal/de/index/ogd/werkstatt.html