dawum.de
RSS-Seite
Facebook-Seite
Twitter-Seite
Google+-Seite
Tumblr-Seite
Pinterest-Seite
Instagram-Seite
Telegram-Seite

Datenbank-API für Wahlumfragen als JSON-Datei (Open Data, ODbL)

Wir stellen unsere Datenbank mit Wahlumfragen als API über eine JSON-Datei im Rahmen von Open Data unter der ODC Open Database License (ODC-ODbL) der Allgemeinheit zur Verfügung.

Inhalt der API

Diese JSON-Datei beinhaltet Informationen einer jeden Wahlumfrage über:

  • Parlament, Institut und Auftraggeber
  • Umfrageergebnisse für die einzelnen Parteien
  • Tag der Veröffentlichung
  • Befragungszeitraum und Anzahl der Befragten

Unsere API wird bei Eintragung einer neuen Wahlumfrage in unsere Datenbank automatisch aktualisiert und ist so stets auf dem gleichen Stand wie unsere SQL-Datenbank. Die API enthält Wahlumfragen zu Bundes- und Landtagswahlen ab 2017.

Aufbau der JSON-Datei

Die JSON-Datei setzt sich aus sechs Blöcken zusammen:

  • Database: Informationen über die Datenbank
    • License: lange (Name) und kurze (Shortcut) Bezeichnung der Lizenz mit Adresse der Website (Link)
    • Publisher: Domain unserer Seite
    • Author: Ersteller der Datenbank
  • Parliaments: IDs und Bezeichnungen
    • Shortcut: Bundesland / Bundestag
    • Name: Bezeichnung des Parlaments
    • Election: Bezeichnung der Wahl
  • Institutes: IDs und Bezeichnung der Institute (Name)
  • Taskers: IDs und Bezeichnungen der Auftraggeber (Name)
  • Parties: IDs und Bezeichnungen
    • Shortcut: Abkürzung der Partei
    • Name: vollständige Bezeichnung der Partei
  • Surveys: IDs und Details zu Wahlumfragen
    • Parliament_ID, Institute_ID, Tasker_ID
    • Results: Partei-ID mit Umfrageergebnis
    • Date: Veröffentlichungsdatum (in ISO 8601)
    • Survey_Period: Befragungszeitraum mit Date_Start und Date_End
    • Surveyed_Persons: Anzahl der Befragten

Nutzung der API

Unsere Datenbank, die über unsere API verfügbar ist, kann im Rahmen der Lizenz ODC-ODbL verwendet werden. Dies setzt insbesondere die Nennung und Verlinkung unserer Seite (dawum.de) sowie die Beibehaltung und Nennung der Lizenz ODC-ODbL voraus.

Beispiel für die Nutzung der JSON-Datei in PHP

Beispielsweise lässt sich mit unserer API eine Tabelle über Wahlumfragen durch Einbindung der JSON-Datei einfach realisieren. Im Folgenden ein Code-Beispiel für PHP zur Ausgabe unserer Datenbank:

// Auslesen der JSON-Datei $JSON_File = file_get_contents('https://api.dawum.de/'); $PHP_Array = json_decode($JSON_File, true); // Sortierung der Parteien (ID) nach den Umfragewerten foreach ($PHP_Array['Surveys'] AS $Surveys) { foreach ($Surveys['Results'] AS $Party_ID => $Result) { $Parties_Sum[$Party_ID] += $Result; $Parties_Count[$Party_ID] += 1; } } // Bildung des Durchschnitts je Partei foreach ($Parties_Sum AS $Party_ID => $Party_Sum) { $Parties_Average[$Party_ID] = ($Party_Sum/$Parties_Count[$Party_ID]); } arsort($Parties_Average); // Ausgabe des Tabellenkopfes echo '<table><thead><td>Datum</td><td>Parlament</td><td>Institut</td><td>Auftraggeber</td>'; foreach ($Parties_Average AS $Party_ID => $Party_Average) { echo '<td title="'.$PHP_Array['Parties'][$Party_ID]['Name'].'">'.$PHP_Array['Parties'][$Party_ID]['Shortcut'].'</td>'; } echo '</thead>'; // Ausgabe des Tabellenkörpers foreach ($PHP_Array['Surveys'] AS $Content) { echo '<tr><td>'.$Content['Date'].'</td><td>'.$PHP_Array['Parliaments'][$Content['Parliament_ID']]['Name'].'</td><td>'.$PHP_Array['Institutes'][$Content['Institute_ID']]['Name'].'</td><td>'.$PHP_Array['Taskers'][$Content['Tasker_ID']]['Name'].'</td>'; // Ausgabe der Parteien/Umfragewerte in der Reihenfolge des Tabellenkopfes foreach ($Parties_Average AS $Party_ID => $Party_Average) { echo '<td>'.$Content['Results'][$Party_ID].'</td>'; } echo '</tr>'; } echo '</table>';

Die Ausgabe dieses Codes kann man sich hier anschauen.

Fragen zur Einbindung unserer API

Bei Fragen zur Einbindung unserer API können Sie sich gerne an uns wenden.