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:
|
|
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:
|
|
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.