Representatives: representativeInfoByAddress

Tek bir adres için siyasi coğrafya ve temsili bilgileri arar. Şimdi deneyin.

İstek

HTTP isteği

GET https://www.googleapis.com/civicinfo/v2/representatives

Parametreler

Parametre adı Değer Açıklama
İsteğe bağlı sorgu parametreleri
address string Aranacak adres. Yalnızca ocdId alanı şöyle değilse belirtilebilir değerini alır.
includeOffices boolean Ofisler ve görevlilerle ilgili bilgilerin iade edilip edilmeyeceğini belirler. Yanlış ise yalnızca en üst düzey bölge bilgileri döndürülür. (Varsayılan: true)
levels string Filtrelenecek ofis düzeylerinin listesi. Yalnızca en az şu hizmet veren ofisler: bu seviyelerden biri döndürülür. Bir eşleşen ofis geri verilmeyecektir.

Kabul edilen değerler şunlardır:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Filtrelenecek ofis rollerinin listesi. Yalnızca şunlardan birini karşılayan ofisler: bu roller döndürülür. Eşleşme içermeyen bölümler geri verilmeyecektir.

Kabul edilen değerler şunlardır:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

İstek içeriği

Bu yöntemle istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "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
        }
      ]
    }
  ]
}
Mülk adı Değer Açıklama Notlar
kind string Bunun ne tür bir kaynak olduğunu tanımlar. Değer: sabit "civicinfo#representativeInfoResponse" dizesi.
normalizedInput nested object İstenen adresin normalleştirilmiş sürümü
normalizedInput.locationName string Konumun adı.
normalizedInput.line1 string Bu adresin sokak adı ve numarası.
normalizedInput.line2 string İkinci satır ise adresi içerir.
normalizedInput.line3 string Gerekirse adresin üçüncü satırı.
normalizedInput.city string Adresin bulunduğu şehir veya ilçe.
normalizedInput.state string Adresin ABD'de iki harfli eyalet kısaltması.
normalizedInput.zip string Adresin ABD Posta Kodu.
divisions object Talep edilen içeriği içeren siyasi coğrafi bölümler girin. Daha fazla bilgi için bkz. Temsilciler source dokümanlarına göz atabilirsiniz.
offices[] list Yukarıda listelenen bölümler tarafından referans verilen, seçilmiş makamlar. Vade yalnızca istekte includeOffices doğruysa mevcut olmalıdır. Daha fazla bilgi için bkz. Temsilciler source dokümanlarına göz atabilirsiniz.
officials[] list Yukarıda listelenen ofislere sahip yetkililer. Yalnızca mevcut olacak includeOffices öğesi istekte doğruysa. Daha fazla bilgi için bkz. Temsilciler source dokümanlarına göz atabilirsiniz.

Deneyin!