Sucht nach politischen geographischen und repräsentativen Informationen für eine einzelne Adresse. Jetzt testen
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/civicinfo/v2/representatives
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Optionale Abfrageparameter | ||
address |
string |
Die nachzuschlagende Adresse. Darf nur angegeben werden, wenn das Feld „ocdId“ nicht in der URL angegeben ist. |
includeOffices |
boolean |
Gibt an, ob Informationen zu Ämtern und Amtsträgern zurückgegeben werden sollen. Bei „false“ werden nur die Informationen zu den oberen Bezirken zurückgegeben.
(Standard: true )
|
levels |
string |
Eine Liste der Büroebenen, nach denen gefiltert werden soll. Es werden nur Büros zurückgegeben, die mindestens eine dieser Ebenen bedienen. Abteilungen, die kein passendes Büro enthalten, werden nicht zurückgegeben.
Zulässige Werte sind:
|
roles |
string |
Eine Liste von Ämtern, nach denen gefiltert werden soll. Es werden nur Büros zurückgegeben, die eine dieser Rollen erfüllen. Abteilungen, die kein entsprechendes Büro enthalten, werden nicht zurückgegeben.
Zulässige Werte sind:
|
Anfragetext
Mit dieser Methode keinen Anfragetext bereitstellen.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "civicinfo#representativeInfoResponse", "normalizedInput": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "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 } ] } ] }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
kind |
string |
Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "civicinfo#representativeInfoResponse" . |
|
normalizedInput |
nested object |
Die normalisierte Version der angeforderten Adresse | |
normalizedInput.locationName |
string |
Der Name des Standorts | |
normalizedInput.line1 |
string |
Der Straßenname und die Hausnummer dieser Adresse. | |
normalizedInput.line2 |
string |
In der zweiten Zeile die Adresse, falls erforderlich. | |
normalizedInput.line3 |
string |
Die dritte Zeile der Adresse, falls erforderlich. | |
normalizedInput.city |
string |
Stadt oder Ort der Adresse. | |
normalizedInput.state |
string |
Die aus zwei Buchstaben bestehende Abkürzung des Bundesstaats der Adresse aus den USA. | |
normalizedInput.zip |
string |
US-Postleitzahl der Adresse | |
divisions |
object |
Politische geografische Unterteilungen, in denen die Adresse angegeben ist. Weitere Informationen finden Sie in der Dokumentation zu Repräsentantenressourcen. | |
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. Weitere Informationen finden Sie in der Dokumentation zu Repräsentantenressourcen. | |
officials[] |
list |
Beamte mit den oben genannten Ämtern. Ist nur vorhanden, wenn "includeOffices" in der Anfrage auf "true" gesetzt war. Weitere Informationen finden Sie in der Dokumentation zu Repräsentantenressourcen. |