Koleksi ini mencakup informasi tentang lokasi geografis politik, serta pejabat terpilih.
Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
Referensi dalam koleksi ini memiliki tiga bagian yang dijelaskan secara mendetail di bawah. Bagian divisions
mencantumkan divisi geografis politik, seperti negara, negara bagian, county, atau distrik legislatif. (Divisi yang akan dicantumkan bergantung pada permintaan API khusus yang dibuat.) Bagian offices
mencantumkan posisi politik yang dipilih untuk mewakili pembagian di bagian pertama. Bagian officials
mencantumkan orang-orang yang saat ini bertugas di kantor yang tercantum.
{ "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 } ] } ] }
Geografi Politik
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
divisions |
object |
Divisi geografis politik yang berisi alamat yang diminta. | |
divisions.(key) |
nested object |
ID Open Civic Data unik untuk divisi ini. | |
divisions.(key).alsoKnownAs[] |
list |
ID OCD valid lainnya yang merujuk ke divisi yang sama. Karena ID OCD dimaksudkan agar dapat dibaca manusia dan setidaknya dapat diprediksi, terkadang ada beberapa ID untuk satu divisi. ID ini didefinisikan setara dengan satu sama lain, dan satu ID selalu diindikasikan sebagai ID utama. ID utama akan ditampilkan dalam ocd_id di atas, dan ID valid lainnya yang setara akan ditampilkan dalam daftar ini. Misalnya, jika ID OCD divisi ini adalah ocd-division/country:us/district:dc, ID ini akan berisi ocd-division/country:us/state:dc. |
|
divisions.(key).name |
string |
Nama divisi. | |
divisions.(key).officeIndices[] |
list |
Daftar indeks dalam array offices , satu untuk setiap kantor yang dipilih dari divisi ini. Hanya akan ada jika includeOffices benar (atau tidak ada) dalam permintaan. |
Kantor Terpilih
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
offices[] |
list |
Kantor terpilih yang dirujuk oleh divisi yang tercantum di atas. Hanya akan ada jika includeOffices bernilai benar dalam permintaan. | |
offices[].divisionId |
string |
ID OCD divisi yang terkait dengan kantor ini. | |
offices[].levels[] |
list |
Tingkat pemerintah di mana kantor ini berada. Mungkin akan ada lebih dari satu kasus ketika wilayah hukum secara efektif bertindak di dua tingkat pemerintahan yang berbeda; misalnya, wali kota District of Columbia bertindak di tingkat "lokalitas", tetapi juga secara efektif di administrativeArea2 dan administrativeArea1 .Nilai yang valid meliputi:
|
|
offices[].name |
string |
Nama kantor yang dapat dibaca manusia. | |
offices[].officialIndices[] |
list |
Daftar indeks dalam jajaran pejabat yang saat ini menduduki jabatan ini. | |
offices[].roles[] |
list |
Peran yang dipenuhi kantor ini. Peran tidak dimaksudkan untuk mencakup seluruh tugas atau untuk menentukan seluruh rangkaian tanggung jawab kantor tertentu, tetapi dimaksudkan sebagai kategori kasar yang berguna untuk pemilihan umum atau pengurutan daftar kantor. Nilai yang valid mencakup:
|
|
offices[].sources[] |
list |
Daftar sumber untuk kantor ini. Jika ada beberapa sumber yang dicantumkan, data telah diagregasi dari sumber-sumber tersebut. | |
offices[].sources[].name |
string |
Nama sumber data. | |
offices[].sources[].official |
boolean |
Apakah data ini berasal dari sumber resmi pemerintah. |
Pejabat Terpilih
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
officials[] |
list |
Pejabat yang memegang jabatan yang tercantum di atas. Hanya akan ada jika includeOffices bernilai benar dalam permintaan. | |
officials[].address[] |
list |
Alamat yang dapat digunakan untuk menghubungi pejabat. | |
officials[].address[].city |
string |
Kota untuk alamat. | |
officials[].address[].line1 |
string |
Nama jalan dan nomor untuk alamat ini. | |
officials[].address[].line2 |
string |
Baris kedua alamat, jika diperlukan. | |
officials[].address[].line3 |
string |
Baris ketiga alamat, jika perlu. | |
officials[].address[].locationName |
string |
Nama lokasi. | |
officials[].address[].state |
string |
Singkatan dua huruf negara AS untuk alamat. | |
officials[].address[].zip |
string |
Kode Pos Amerika Serikat untuk alamat tersebut. | |
officials[].channels[] |
list |
Daftar channel media (sosial) yang diketahui untuk pejabat ini. | |
officials[].channels[].id |
string |
ID publik unik untuk channel kandidat. | |
officials[].channels[].type |
string |
Jenis channel. Berikut ini daftar jenis saluran, tetapi ini tidak lengkap. Jenis saluran lainnya dapat ditambahkan di lain waktu. Salah satu dari: YouTube, Facebook, Twitter | |
officials[].emails[] |
list |
Alamat email langsung untuk pejabat. | |
officials[].name |
string |
Nama pejabat. | |
officials[].party |
string |
Nama lengkap partai tempat pejabat tersebut berada. | |
officials[].phones[] |
list |
Nomor telepon kontak publik milik pejabat tersebut. | |
officials[].photoUrl |
string |
URL untuk foto pejabat. | |
officials[].urls[] |
list |
URL situs publik resmi milik pejabat tersebut. |
Metode
- representativeInfoByAddress
- Mencari lokasi geografis politik dan informasi perwakilan untuk satu alamat.
- representativeInfoByDivision
- Mencari informasi representatif untuk satu divisi geografis.