Bu sayfa, Cloud Translation API ile çevrilmiştir.

Representatives

Bu koleksiyon, seçimle göreve gelmiş yetkililerin yanı sıra siyasi coğrafyayla ilgili bilgiler içerir.

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Bu koleksiyondaki bir kaynak, aşağıda ayrıntılı olarak açıklanan üç bölümden oluşur. divisions bölümünde ülke, eyalet, ilçe veya yasama bölgesi gibi siyasi coğrafi bölümler listelenir. (Hangi bölümlerin listeleneceği, yapılan API isteğine bağlıdır.) offices bölümünde, ilk bölümdeki bölümleri temsil etmek üzere seçilen siyasi konumlar listelenir. officials bölümünde, listelenen ofislerde o anda görev yapan kişiler listelenir.

{
  "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
        }
      ]
    }
  ]
}

Siyasi Coğrafya

Mülk adı	Değer	Açıklama
`divisions`	`object`	İstenen adresi içeren siyasi coğrafi bölümler.
`divisions.(key)`	`nested object`	Bu bölümün benzersiz Open Civic Data tanımlayıcısı.
`divisions.(key).alsoKnownAs[]`	`list`	Aynı bölüme atıfta bulunan diğer geçerli OCD kimlikleri. OCD kimliklerinin kullanıcılar tarafından okunabilmesi ve en azından tahmin edilebilir olması amaçlandığından, zaman zaman tek bir bölüm için birkaç tanımlayıcı bulunur. Bu tanımlayıcıların birbirine eşdeğer olduğu tanımlanır ve biri her zaman birincil tanımlayıcı olarak belirtilir. Birincil tanımlayıcı yukarıdaki ocd_id öğesinde, eşdeğer olan diğer tüm geçerli tanımlayıcılar bu listede döndürülür. Örneğin, bu bölümün OCD kimliği ocd-division/country:us/district:dc ise bu değer ocd-division/country:us/state:dc ifadesini içerir.
`divisions.(key).name`	`string`	Bölümün adı.
`divisions.(key).officeIndices[]`	`list`	`offices` dizisindeki, bu bölümden seçilen her makam için bir adet dizin listesi. Yalnızca istekte `includeOffices` doğru olduğunda (veya yoksa) kullanılabilir.

Seçilen Ofisler

Mülk adı	Değer	Açıklama
`offices[]`	`list`	Yukarıda listelenen bölümler tarafından referans verilen, seçilmiş makamlar. Yalnızca istekte includeOffices doğruysa mevcut olur.
`offices[].divisionId`	`string`	Bu ofisin ilişkili olduğu bölümün OCD kimliği.
`offices[].levels[]`	`list`	Bu makamın parçası olduğu yönetim düzeyleri. Bir yargı alanının iki farklı devlet düzeyinde etkin bir şekilde faaliyet gösterdiği birden fazla durum söz konusu olabilir; Örneğin, District of Columbia belediye başkanı "mahalle"de hareket etmektedir ancak hem `administrativeArea2` hem de `administrativeArea1` düzeyinde etkili bir şekilde çalışır. Geçerli değerler şunlardır: `international` -- Uluslararası hükûmetler (ör. Birleşmiş Milletler veya Avrupa Birliği). `country` -- ABD Federal Hükümeti gibi ulusal düzeydeki hükümetler. `administrativeArea1` -- Bir ülkenin en üst düzey idari alt bölümünün devletleri (ör. ABD eyaletleri). `regional` -- Yargı alanı standart idari alt bölümleri geçebilen bölgesel yönetimler; Bunlar ABD'de yaygın değildir ancak diğer ülkelerdeki büyük şehirlerde yaygın olarak kullanılır. `administrativeArea2` -- Bir ülkenin ikinci düzey idari alt bölümünün devletleri (ör. ABD ilçeleri). `locality` -- Şehir veya belediye yönetimleri. `subLocality1` -- Bir şehrin en üst düzey idari alt bölümünün yönetimleri (ör. Washington, DC'nin bölgeleri). `subLocality2` -- Bir şehrin ikinci düzey idari alt bölümünün yönetimleri (ör. Washington, DC'nin Danışma Mahallesi Konseyi). `special` -- Yalnızca özel amaçlı yönetimler için var olan yerel bölgeler (ör. toprak ve su koruma bölgeleri).
`offices[].name`	`string`	Ofisin kullanıcılar tarafından okunabilen adı.
`offices[].officialIndices[]`	`list`	Şu anda bu makamda görev yapan yetkililer dizisindeki dizinlerin listesi.
`offices[].roles[]`	`list`	Bu ofisin yerine getirdiği roller. Roller her şeyi kapsamaz veya belirli bir ofisin tüm sorumluluklarını tam olarak belirtmeye yönelik değildir. Roller, ofislerden genel seçim ya da ofisler listesinden genel seçimler için kullanışlı olan genel kategoriler olarak tasarlanmıştır. Geçerli değerler şunlardır: `headOfState` -- Bir hükümetin baş temsilcisidir. Bir ülkenin devlet başkanına genellikle Cumhurbaşkanı denir. `headOfGovernment` -- Bir devletin CEO'sudur. ABD'de bu, Cumhurbaşkanı'dır. diğer ülkelerde ise başbakandır. Daha alt düzeylerde bu kişi bir vali veya belediye başkanı olabilir. `deputyHeadOfGovernment` -- Seçilen devlet başkanının ölümü veya yetersizliği durumunda devletin başkanlığını üstlenmekten sorumlu memur. ABD'de bu kişi Başkan Yardımcısıdır. Bu ofisin başka görevleri de olabilir. `governmentOfficer` -- Seçilmiş bir idari birim. ABD eyaletlerinde bu rollere başsavcı, komptroller, sekreter veya eyalet ya da haziran gibi roller de dahil olabilir. `executiveCouncil` -- Grup olarak idari şube görevlerini yerine getiren bir yönetim konseyi üyesi. Bunun örnekleri arasında Indiana ilçesinin yetkilileri yer alır. `legislatorUpperBody` -- İki meclisli yasama meclisinin üst organının üyesi veya tek meclisli yasama meclisinin tek organı. `legislatorLowerBody` -- İki meclisli yasama meclisinin alt meclisinin üyesi. `highestCourtJudge` -- Belirli bir hükümetin (eyaletteki Yüksek Mahkeme gibi) üst mahkemenin hakimidir. `judge` -- Hizmet verdiği hükümetin üst mahkemesi olmayan herhangi bir mahkemedeki hakim. `schoolBoard` -- Yerel okul kurulu üyesidir. `specialPurposeOfficer` -- Toprak ve su koruma kurulu üyesi veya sivrisinek önleme memuru gibi tek bir amaca hizmet eden memur.
`offices[].sources[]`	`list`	Bu ofisle ilgili kaynakların listesi. Birden fazla kaynak listeleniyorsa veriler bu kaynaklardan toplanmıştır.
`offices[].sources[].name`	`string`	Veri kaynağının adı.
`offices[].sources[].official`	`boolean`	Bu verilerin resmi bir devlet kaynağından gelip gelmediği.

Seçilen Yetkililer

Mülk adı	Değer	Açıklama
`officials[]`	`list`	Yukarıda listelenen ofislere sahip yetkililer. Yalnızca istekte includeOffices doğruysa mevcut olur.
`officials[].address[]`	`list`	Yetkili kişiyle iletişim kurulacak adresler.
`officials[].address[].city`	`string`	Adresin bulunduğu şehir veya ilçe.
`officials[].address[].line1`	`string`	Bu adresin sokak adı ve numarası.
`officials[].address[].line2`	`string`	İkinci satır ise adresi içerir.
`officials[].address[].line3`	`string`	Gerekirse adresin üçüncü satırı.
`officials[].address[].locationName`	`string`	Konumun adı.
`officials[].address[].state`	`string`	Adresin ABD'de iki harfli eyalet kısaltması.
`officials[].address[].zip`	`string`	Adresin ABD Posta Kodu.
`officials[].channels[]`	`list`	Bu resmi görevlinin bilinen (sosyal) medya kanallarının listesi.
`officials[].channels[].id`	`string`	Adanın kanalı için herkese açık benzersiz tanımlayıcıdır.
`officials[].channels[].type`	`string`	Kanalın türü. Aşağıda kanal türlerinin listesi verilmiştir ancak olası her örneğe yer verilmemiştir. Gelecekte başka kanal türleri eklenebilir. Şunlardan biri: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	Yetkilinin doğrudan e-posta adresleri.
`officials[].name`	`string`	Yetkilinin adı.
`officials[].party`	`string`	Yetkilinin ait olduğu partinin tam adı.
`officials[].phones[]`	`list`	Yetkilinin genel iletişim telefon numaraları.
`officials[].photoUrl`	`string`	Resmi görevlinin fotoğrafının URL'si.
`officials[].urls[]`	`list`	Yetkili kişinin herkese açık web sitesinin URL'leri.

Yöntemler

representativeInfoByAddress: Tek bir adres için siyasi coğrafya ve temsili bilgileri arar.
representativeInfoByDivision: Tek bir coğrafi bölüm için temsili bilgiler arar.