Representatives

Diese Sammlung umfasst Informationen zur politischen Geografie sowie zu gewählten Amtsträgern.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Ressource in dieser Sammlung besteht aus drei Abschnitten, die unten ausführlich beschrieben werden. Im Abschnitt divisions sind die geografischen Gliederungen aufgeführt, z. B. ein Land, ein Bundesland, ein Landkreis oder ein Gesetzgebungsbezirk. Welche Abteilungen aufgelistet werden, hängt von der jeweiligen API-Anfrage ab. Im Abschnitt offices sind die politischen Positionen aufgeführt, die im ersten Abschnitt für die Repräsentation der Divisionen gewählt wurden. Im Abschnitt officials sind Personen aufgeführt, die derzeit in den aufgeführten Büros tätig sind.

{
  "divisions": {
    (key): {
      "name": string,
      "alsoKnownAs": [
        string
      ],
      "officeIndices": [
        unsigned integer
      ]
    }
  },
  "offices": [
    {
      "name": string,
      "divisionId": string,
      "levels": [
        string
      ],
      "roles": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ],
      "officialIndices": [
        unsigned integer
      ]
    }
  ],
  "officials": [
    {
      "name": string,
      "address": [
        {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        }
      ],
      "party": string,
      "phones": [
        string
      ],
      "urls": [
        string
      ],
      "photoUrl": string,
      "emails": [
        string
      ],
      "channels": [
        {
          "type": string,
          "id": string
        }
      ]
    }
  ]
}

Politische Geografie

Property-Name Wert Beschreibung Hinweise
divisions object Politische geografische Unterteilungen, in denen die Adresse angegeben ist.
divisions.(key) nested object Die eindeutige Kennung für Open Civic Data für diese Abteilung.
divisions.(key).alsoKnownAs[] list Alle anderen gültigen OCD-IDs, die sich auf dieselbe Abteilung beziehen.

Da OCD-IDs für Menschen lesbar und zumindest vorhersehbar sein sollen, gibt es gelegentlich mehrere Kennungen für eine einzelne Abteilung. Diese Kennungen sind so definiert, dass sie einander entsprechen, und eine der Kennungen wird immer als primäre Kennungen angegeben. Die primäre ID wird oben in „ocd_id“ zurückgegeben. Alle anderen äquivalenten gültigen Kennungen werden in dieser Liste zurückgegeben.

Wenn die OCD-ID der Abteilung beispielsweise „ocd-division/country:us/district:dc“ lautet, ist „ocd-division/country:us/state:dc“ enthalten.
divisions.(key).name string Der Name der Abteilung.
divisions.(key).officeIndices[] list Liste der Indizes im Array offices, einer für jedes aus dieser Abteilung gewählte Amt. Ist nur vorhanden, wenn includeOffices in der Anfrage wahr (oder nicht vorhanden) war.

Gewählte Ämter

Property-Name Wert Beschreibung Hinweise
offices[] list Gewählte Ämter, auf die sich die oben genannten Abteilungen beziehen. Ist nur vorhanden, wenn "includeOffices" in der Anfrage auf "true" gesetzt war.
offices[].divisionId string Die OCD-ID der Abteilung, mit der dieses Büro verknüpft ist.
offices[].levels[] list Die Regierungsebenen, zu denen dieses Büro gehört. Es kann mehrere Fälle geben, in denen eine Gerichtsbarkeit effektiv auf zwei verschiedenen Regierungsebenen agiert. So agiert der Bürgermeister des District of Columbia beispielsweise auf Ortsebene, aber auch effektiv sowohl auf administrativeArea2- als auch auf administrativeArea1-Ebene.

Gültige Werte: 
  • international: Internationale Regierungen wie die Vereinten Nationen oder die Europäische Union
  • country : Regierungen auf nationaler Ebene, z. B. die US-Bundesregierung
  • administrativeArea1: Regierungen der obersten Verwaltungseinheit eines Landes, z. B. US-Bundesstaaten
  • regional: Regionalregierungen, deren Zuständigkeit sich über standardmäßige Verwaltungsbezirke hinweg erstreckt. Dies ist in den USA ungewöhnlich, aber in Großstädten anderer Länder üblich.
  • administrativeArea2: Regierungen der zweitrangigen Verwaltungseinheit eines Landes, beispielsweise US-Bezirken
  • locality: Stadt- oder Kommunalverwaltungen.
  • subLocality1: Regierungen der obersten Verwaltungseinheit einer Stadt, z. B. Washington, D.C.
  • subLocality2: Regierungen der zweitrangigen Verwaltungseinheit einer Stadt,z. B. die Beratungs-Nachbarschaftsräte von Washington, D.C.
  • special: Bezirke, die nur für Sonderverwaltungen vorhanden sind, z. B. Boden- und Wasserschutzbezirke.
offices[].name string Der visuell lesbare Name des Büros.
offices[].officialIndices[] list Liste der Indizes unter den Beamten, die dieses Amt derzeit innehaben.
offices[].roles[] list Die Rollen, die dieses Büro erfüllt. Rollen sind nicht vollständig oder geben nicht alle Zuständigkeiten eines bestimmten Büros genau an. Es handelt sich lediglich um grobe Kategorien, die für die allgemeine Auswahl aus einer Liste oder das Sortieren einer Liste von Büros nützlich sind.

Zulässige Werte sind:
  • headOfState : Der wichtigste Vertreter einer Regierung. Das Staatsoberhaupt eines Landes wird in der Regel als Präsident bezeichnet.
  • headOfGovernment: Der Chief Executive Officer einer Regierung. In den USA ist dies der Präsident, in anderen Ländern oft der Premierminister. Auf niedrigeren Ebenen kann das ein Gouverneur oder Bürgermeister sein.
  • deputyHeadOfGovernment: Amtsträger, der im Falle des Todes oder der Unfähigkeit des gewählten Regierungschefs die Rolle des Regierungschefs übernimmt In den USA ist das der Vizepräsident. Dieses Büro kann noch weitere Aufgaben erfüllen.
  • governmentOfficer: Ein gewählter Executive-Officer. In US-Bundesstaaten sind das beispielsweise Generalstaatsanwalt, Steuerberater, Sekretär oder Staatssekretär oder Schatzmeister.
  • executiveCouncil: Ein Mitglied eines Vorstands, das als Gruppe führende Positionen innehaben. Ein Beispiel hierfür sind die Beauftragten der Region Indiana.
  • legislatorUpperBody: Mitglied des Oberkörpers eines Zwei-Kamera-Legislatives oder des einzigen Körpers einer Zwei-Kamera-Legislative.
  • legislatorLowerBody: Ein Mitglied des Unterkörpers eines zweikameraellen Legislatives.
  • highestCourtJudge: Ein Richter des obersten Gerichts einer bestimmten Regierung, z. B. des Obersten Gerichtshofs.
  • judge: Ein Richter eines Gerichts, das nicht das oberste Gericht der Regierung ist, deren Aufgabe es ist.
  • schoolBoard: Mitglied einer lokalen Schulbehörde.
  • specialPurposeOfficer: Ein Beamter mit einem bestimmten, festgelegten Zweck, z. B. Mitglied eines Boards für den Schutz von Boden und Wasser oder für die Bekämpfung von Mückenschutz.
offices[].sources[] list Eine Liste der Quellen für dieses Büro. Wenn mehrere Quellen aufgeführt sind, wurden die Daten aus diesen Quellen aggregiert.
offices[].sources[].name string Der Name der Datenquelle.
offices[].sources[].official boolean Ob diese Daten von einer offiziellen Regierungsquelle stammen.

Gewählte Amtsträger

Property-Name Wert Beschreibung Hinweise
officials[] list Beamte mit den oben genannten Ämtern. Ist nur vorhanden, wenn "includeOffices" in der Anfrage auf "true" gesetzt war.
officials[].address[] list Adressen, unter denen der Beamte kontaktiert werden kann.
officials[].address[].city string Stadt oder Ort der Adresse.
officials[].address[].line1 string Der Straßenname und die Hausnummer dieser Adresse.
officials[].address[].line2 string In der zweiten Zeile die Adresse, falls erforderlich.
officials[].address[].line3 string Die dritte Zeile der Adresse, falls erforderlich.
officials[].address[].locationName string Der Name des Standorts
officials[].address[].state string Die aus zwei Buchstaben bestehende Abkürzung des Bundesstaats der Adresse aus den USA.
officials[].address[].zip string US-Postleitzahl der Adresse
officials[].channels[] list Eine Liste mit bekannten Kanälen (soziale Medien) für diesen Amtsträger.
officials[].channels[].id string Die eindeutige öffentliche Kennung für den Kanal des Kandidaten.
officials[].channels[].type string Der Kanaltyp. Im Folgenden finden Sie eine Liste verschiedener Kanaltypen, ist jedoch nicht vollständig. Weitere Kanaltypen können zu einem späteren Zeitpunkt hinzugefügt werden. Eine der folgenden Optionen: YouTube, Facebook, Twitter
officials[].emails[] list Die direkten E-Mail-Adressen des Beamten.
officials[].name string Der Name des Amtsträgers.
officials[].party string Der vollständige Name der Partei, zu der der Amtsträger gehört.
officials[].phones[] list Die öffentlichen Kontakttelefonnummern des Amtsträgers.
officials[].photoUrl string Eine URL für ein Foto des Amtsträgers.
officials[].urls[] list Die öffentlichen Website-URLs des Amtsträgers.

Methoden

representativeInfoByAddress
Sucht nach politischen Regionen und repräsentativen Informationen für eine einzelne Adresse.
representativeInfoByDivision
Nach repräsentativen Informationen für eine einzelne geografische Unterteilung suchen.