Diese Seite wurde von der Cloud Translation API übersetzt.

Representatives

Diese Sammlung enthält Informationen zu politischen Regionen 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 genauer beschrieben werden. Im Bereich „divisions“ sind politische geografische Unterteilungen aufgeführt, z. B. ein Land, ein Bundesland, ein Landkreis oder ein Gesetzgebungsbezirk. Welche Bereiche aufgeführt werden, hängt von der jeweiligen API-Anfrage ab. Im Abschnitt offices sind politische Positionen aufgeführt, die für die Divisionen im ersten Abschnitt 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
`divisions`	`object`	Politische geografische Einheiten, die die angeforderte Adresse enthalten
`divisions.(key)`	`nested object`	Die eindeutige Open Civic Data-Kennung für diese Abteilung.
`divisions.(key).alsoKnownAs[]`	`list`	Alle anderen gültigen OCD-IDs, die sich auf dieselbe Division beziehen. Da OCD-IDs für Menschen lesbar und zumindest vorhersehbar sein sollen, gibt es gelegentlich mehrere Kennungen für eine einzelne Division. Diese IDs sind so definiert, dass sie einander entsprechen, und eine ID wird immer als primäre Kennung angegeben. Die primäre Kennung wird oben in ocd_id zurückgegeben, und alle anderen äquivalenten gültigen Kennzeichnungen werden in dieser Liste zurückgegeben. Wenn die OCD-ID dieser Division beispielsweise „ocd-division/country:us/district:dc“ lautet, enthält das Feld „ocd-division/country:us/state:dc“.
`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 „true“ oder nicht vorhanden war.

Gewählte Ämter

Property-Name	Wert	Beschreibung
`offices[]`	`list`	Gewählte Ämter, auf die sich die oben genannten Abteilungen beziehen. Ist nur vorhanden, wenn „includeOffices“ in der Anfrage „true“ war.
`offices[].divisionId`	`string`	Die OCD-ID der Abteilung, der dieses Büro zugeordnet ist.
`offices[].levels[]`	`list`	Die Regierungsebenen, zu denen dieses Amt angehört. Es kann mehr als einen Fall geben, wenn eine Gerichtsbarkeit effektiv auf zwei verschiedenen Regierungsebenen handelt. Beispielsweise gibt der Bürgermeister des District of Columbia den Standort "Ort" an. und gleichzeitig effektiv sowohl auf `administrativeArea2` als auch auf `administrativeArea1`. Gültige Werte sind: `international`: Internationale Regierungen wie die Vereinten Nationen oder die Europäische Union `country` : Behörden auf nationaler Ebene, z. B. die US-Bundesregierung. `administrativeArea1`: Regierungen der obersten Verwaltungseinheit eines Landes, z. B. US-Bundesstaaten. `regional`: Regionale Behörden, deren Zuständigkeit sich über mehrere Verwaltungseinheiten erstreckt in den USA eher selten, bei Großstädten in anderen Ländern jedoch häufig. `administrativeArea2`: Regierungen der zweiten Verwaltungseinheit eines Landes, z. B. die Countys der USA. `locality`: Stadt- oder kommunale Behörden `subLocality1`: Regierungen der obersten Verwaltungseinheit einer Stadt, z. B. die Bezirke von Washington, D.C. `subLocality2`: Regierungen der zweiten Verwaltungseinheit einer Stadt,z. B. die Beratungsgemeinschaften von Washington, D.C. `special`: Stadtteile, die nur von einer speziellen Regierungsbehörde stammen, z. B. Distrikte für Boden- und Gewässerschutz.
`offices[].name`	`string`	Der visuell lesbare Name des Büros.
`offices[].officialIndices[]`	`list`	Liste der Indizes in der Liste der Beamten, die derzeit dieses Amt innehaben.
`offices[].roles[]`	`list`	Die Aufgaben, die dieses Büro erfüllt. Rollen sollen nicht vollständig sein oder den gesamten Aufgabenbereich eines bestimmten Büros angeben. Es handelt sich dabei um grobe Kategorien, die für die allgemeine Auswahl oder Sortierung einer Liste von Büros nützlich sind. Gültige Werte sind: `headOfState` : Der Chefvertreter 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 ist es häufig der Premierminister. Auf niedrigeren Ebenen kann dies ein Gouverneur oder Bürgermeister sein. `deputyHeadOfGovernment`: Der Amtsträger, der im Falle des Todes oder der Unfähigkeit des gewählten Regierungsoberhaupts für die Rolle des Staatsoberhaupts verantwortlich ist. In den USA ist sie der Vice President. Dieses Büro kann auch andere Aufgaben übernehmen. `governmentOfficer`: Ein gewählter Executive Branch Officer. In US-Bundesstaaten können dies Positionen wie Generalstaatsanwalt, Rechtsbeistand, Sekretär oder Staatssekretär oder Schatzmeister umfassen. `executiveCouncil`: Ein Mitglied eines Vorstands, das als Gruppe Führungspositionen übernimmt. Beispiele hierfür sind die Kommissar des Indiana County. `legislatorUpperBody`: Mitglied des Oberkörpers einer Legislative aus zwei Kammern oder der einzige Körper einer Einraumkammer. `legislatorLowerBody`: Mitglieder des Unterkörpers einer Legislative mit zwei Kammern. `highestCourtJudge`: Ein Richter des obersten Gerichts einer bestimmten Regierung, z. B. des Obersten Gerichtshofs auf bundesstaatlicher Ebene. `judge`: Ein Richter in einem Gericht, das nicht das oberste Gericht der Regierung ist, dem es dient. `schoolBoard`: Ein Mitglied einer lokalen Schulbehörde. `specialPurposeOfficer`: Beamter, der einem bestimmten Zweck dient, z. B. Mitglied eines Gremiums für den Schutz von Boden und Wasser oder für die Bekämpfung von Mücken.
`offices[].sources[]`	`list`	Eine Liste der Quellen für dieses Amt. Sind mehrere Quellen aufgeführt, wurden die Daten aus diesen Quellen zusammengefasst.
`offices[].sources[].name`	`string`	Der Name der Datenquelle.
`offices[].sources[].official`	`boolean`	Ob diese Daten von einer offiziellen staatlichen Quelle stammen.

Gewählte Amtsträger

Property-Name	Wert	Beschreibung
`officials[]`	`list`	Beamte in den oben genannten Ämtern. Ist nur vorhanden, wenn „includeOffices“ in der Anfrage „true“ war.
`officials[].address[]`	`list`	Adressen, unter denen der Amtsträger kontaktiert werden soll.
`officials[].address[].city`	`string`	Der Ort der Adresse.
`officials[].address[].line1`	`string`	Der Straßenname und die Nummer dieser Adresse.
`officials[].address[].line2`	`string`	Die zweite Zeile der 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 der US-Bundesstaaten für die Adresse.
`officials[].address[].zip`	`string`	Die US-Postleitzahl der Adresse.
`officials[].channels[]`	`list`	Eine Liste der bekannten Social-Media-Kanäle dieses Amtsträgers.
`officials[].channels[].id`	`string`	Die eindeutige öffentliche Kennung für den Kanal des Kandidaten.
`officials[].channels[].type`	`string`	Der Typ des Channels. Im Folgenden finden Sie eine Liste der Kanaltypen. Sie ist jedoch nicht vollständig. Weitere Kanaltypen können später hinzugefügt werden. Eine der folgenden Möglichkeiten: YouTube, Facebook oder Twitter
`officials[].emails[]`	`list`	Die direkten E-Mail-Adressen des Amtsträgers.
`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 Telefonnummern des Amtsträgers.
`officials[].photoUrl`	`string`	Eine URL zu einem Foto des Amtsträgers.
`officials[].urls[]`	`list`	Die öffentlichen Website-URLs des Beamten.

Methoden

representativeInfoByAddress: Hier können Sie nach politischen geografischen und repräsentativen Informationen für eine einzelne Adresse suchen.
representativeInfoByDivision: Findet repräsentative Informationen für eine einzelne geografische Unterteilung.