Representatives

Bu koleksiyon, siyasi coğrafya ve seçilmiş görevliler hakkında bilgiler içerir.

Bu kaynağa ilişkin yöntemlerin 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 ve coğrafi bölümler listelenir. (Hangi bölümlerin listeleneceği, yapılan belirli API isteğine bağlıdır.) offices bölümünde, ilk bölümde bölümleri temsil etmek üzere seçilen siyasi pozisyonlar listelenir. officials bölümünde, listelenen ofislerde o anda hizmet veren kullanıcılar 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 Notlar
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 ait diğer geçerli OCD kimlikleri.

OCD kimliklerinin kullanıcılar tarafından okunabilir olması ve en azından biraz öngörülebilir olması amaçlandığından, zaman zaman tek bir bölüm için birkaç tanımlayıcı bulunur. Bu tanımlayıcılar, birbiriyle eşdeğer olacak şekilde tanımlanır ve bir tanesi her zaman birincil tanımlayıcı olarak gösterilir. Birincil tanımlayıcı yukarıdaki ocd_id içinde döndürülecek ve diğer eşdeğer geçerli tanımlayıcılar bu listede döndürülecektir.

Örneğin, bu bölümün OCD Kimliği ocd-division/country:us/district:dc ise bu kimlik, ocd-division/country:us/state:dc içerecektir.
divisions.(key).name string Bölümün adı.
divisions.(key).officeIndices[] list Bu bölümden seçilen her ofis için bir adet olmak üzere offices dizisindeki dizinlerin listesi. Yalnızca istekte includeOffices doğruysa (veya yoksa) mevcut olur.

Seçilen Ofisler

Mülk adı Değer Açıklama Notlar
offices[] list Yukarıda listelenen bölümlerde yer alan seçilmiş makamlar. Yalnızca istekte includeOffices doğru değerine sahipse mevcut olur.
offices[].divisionId string Bu ofisin ilişkili olduğu bölümün OCD Kimliği.
offices[].levels[] list Bu ofisin bağlı olduğu devlet düzeyleri. Bir yargı alanının devletin iki farklı düzeyinde etkin bir şekilde hareket ettiği birden fazla durum olabilir. Örneğin, District of Columbia belediye başkanı "yerel" düzeyinde, ama aynı zamanda hem administrativeArea2 hem de administrativeArea1 düzeyinde etkili bir şekilde hareket eder.

Geçerli değerler şunlardır: 
  • international -- Birleşmiş Milletler veya Avrupa Birliği gibi uluslararası hükümetler.
  • country -- ABD Federal Hükümeti gibi ulusal düzeydeki hükümetler.
  • administrativeArea1 -- ABD eyaletleri gibi bir ülkenin en üst düzey idari alt bölümünün hükümetleri.
  • 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ındır.
  • administrativeArea2 -- ABD ilçeleri gibi bir ülkenin ikinci düzey idari alt bölümünün hükümetleri.
  • locality -- Şehir veya belediye yönetimleri.
  • subLocality1 -- Washington, DC bölgeleri gibi bir şehrin en üst düzey idari alt bölümünün yönetimleri.
  • subLocality2 -- Washington, DC'nin Danışma Mahallesi Konseyi gibi bir şehrin ikinci düzey idari alt bölümünün hükümetleri.
  • special -- Toprak ve su koruma bölgeleri gibi yalnızca özel amaçlı yönetimlere bağlı yerel bölgeler.
offices[].name string Ofisin kullanıcılar tarafından okunabilir adı.
offices[].officialIndices[] list Şu anda bu makamda görev yapan yetkililer dizisindeki endekslerin listesi.
offices[].roles[] list Bu ofisin yerine getirdiği roller. Rollerin kapsamlı olması veya belirli bir ofisin tüm sorumluluklarını tam olarak belirtmesi amaçlanmamıştır. Ancak roller, bir ofis listesinden seçim yaparken veya bir ofis listesinden genel olarak seçim yaparken ya da pozisyonların sıralanmasında faydalı olan kaba kategorilerdir.

Geçerli değerler şunlardır:
  • headOfState -- Bir hükümetin baş kamu temsilcisi. Bir ülkenin devlet başkanına genellikle Cumhurbaşkanı denir.
  • headOfGovernment -- Bir hükümetin CEO'su. ABD'de bu kişi Cumhurbaşkanı, diğer ülkelerde ise genellikle Başbakandır. Daha alt düzeylerde ise vali veya belediye başkanı olabilir.
  • deputyHeadOfGovernment -- Seçilen devlet başkanının ölümü veya yetersizliği durumunda devlet başkanını üstlenmekten sorumlu olan 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 memuru. ABD eyaletlerinde bu pozisyonlar arasında başsavcı, denetmen, sekreter veya eyalet ya da hazinedarlık gibi roller yer alabilir.
  • executiveCouncil -- Grup olarak idari şube rollerini yerine getiren yönetim konseyi üyesidir. Indiana ilçe yetkilileri buna örnek gösterilebilir.
  • legislatorUpperBody -- İki meclisli meclisin üst meclisinin bir üyesi veya tek meclisli bir meclisin tek meclisi.
  • legislatorLowerBody -- İki meclisli meclisin alt organının üyesi.
  • highestCourtJudge -- Eyalet Yüksek Mahkemesi gibi belirli bir hükümetin üst düzey mahkemesinin yargıcı.
  • judge -- Hizmet verdiği hükümetin üst mahkemesi olmayan herhangi bir mahkemede hakimdir.
  • schoolBoard -- Yerel okul yönetiminin bir üyesi.
  • specialPurposeOfficer -- Toprak ve suyu koruma kurulunun bir üyesi veya sivrisineklerle mücadele görevlisi gibi tek ve tanımlanmış bir amaca hizmet eden bir görevli.
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 Notlar
officials[] list Yukarıda listelenen makamlarda görev yapan yetkililer. Yalnızca istekte includeOffices doğru değerine sahipse mevcut olur.
officials[].address[] list Resmi görevliyle 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 Gerekirse adresin ikinci satırında.
officials[].address[].line3 string Gerekirse adresin üçüncü satırı.
officials[].address[].locationName string Konumun adı.
officials[].address[].state string Adresin ABD'de kullanılan 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 Adaya ait kanalın herkese açık benzersiz tanımlayıcısı.
officials[].channels[].type string Kanalın türü. Aşağıda kanal türlerinin bir listesi verilmiştir, ancak olası tüm durumlara yer verilmemiştir. Daha sonra başka kanal türleri de eklenebilir. Şunlardan biri: YouTube, Facebook, Twitter
officials[].emails[] list Resmi kişinin doğrudan e-posta adresleri.
officials[].name string Resmi görevlinin adı.
officials[].party string Görevlinin ait olduğu partinin tam adı.
officials[].phones[] list Resmi görevlinin herkese açık telefon numaraları.
officials[].photoUrl string Resmi görevlinin fotoğrafının URL'si.
officials[].urls[] list Resmi kişinin herkese açık web sitesi 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ü temsil eden bilgileri arar.