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:
|
|
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:
|
|
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.