Representatives: representativeInfoByAddress

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:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
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:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

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.

Jetzt testen