Halaman ini diterjemahkan oleh Cloud Translation API.

Representatives

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
`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
`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: `international` -- Pemerintah internasional, seperti Perserikatan Bangsa-Bangsa atau Uni Eropa. `country` -- Pemerintah tingkat nasional, seperti Pemerintah Federal AS. `administrativeArea1` -- Pemerintah dari subdivisi administratif tingkat teratas sebuah negara, seperti negara bagian AS. `regional` -- Pemerintah regional yang wilayah hukumnya mungkin melintasi subdivisi administratif standar. Hal ini jarang terjadi di AS, tetapi umumnya terjadi di kota-kota besar di negara lain. `administrativeArea2` -- Pemerintah subdivisi administratif tingkat kedua sebuah negara, seperti county AS. `locality` -- Pemerintah kota atau kotamadya. `subLocality1` -- Pemerintah dari subdivisi administratif tingkat teratas sebuah kota, seperti distrik Washington, DC. `subLocality2` -- Pemerintah subdivisi administratif tingkat kedua sebuah kota,seperti Dewan Lingkungan Penasihat Washington, DC. `special` -- Distrik lokal yang hanya ada untuk pemerintah dengan tujuan khusus, seperti distrik konservasi tanah dan air.
`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: `headOfState` -- Perwakilan publik utama dari pemerintah. Kepala negara suatu negara biasanya disebut Presiden. `headOfGovernment` -- Chief Executive Officer di pemerintahan. Di AS, ini adalah Presiden; di negara lain, sering kali berperan sebagai Perdana Menteri. Pada tingkat yang lebih rendah, jabatan ini bisa jadi gubernur atau wali kota. `deputyHeadOfGovernment` -- Pejabat yang bertanggung jawab untuk mengemban jabatan kepala pemerintahan jika kematian atau ketidakmampuan kepala pemerintahan yang dipilih. Di AS, ini adalah Wakil Presiden. Kantor ini mungkin juga memiliki tugas lain. `governmentOfficer` -- Pejabat cabang eksekutif terpilih. Di negara bagian AS, hal ini dapat mencakup peran seperti jaksa agung, pengawas pajak, sekretaris atau negara bagian, atau bendahara. `executiveCouncil` -- Anggota dewan eksekutif yang menjalankan peran cabang eksekutif sebagai sebuah grup. Contohnya termasuk komisioner wilayah Indiana. `legislatorUpperBody` -- Anggota badan atas legislatif bikameral, atau satu-satunya badan legislatif dengan unikameral. `legislatorLowerBody` -- Anggota badan bawah legislatif bikameral. `highestCourtJudge` -- Hakim pengadilan tinggi dari pemerintah tertentu, seperti Mahkamah Agung negara bagian. `judge` -- Hakim di pengadilan mana pun yang bukan pengadilan tingkat atas pemerintah yang dilayaninya. `schoolBoard` -- Anggota dewan sekolah lokal. `specialPurposeOfficer` -- Petugas yang melayani satu tujuan yang ditentukan, seperti anggota dewan konservasi tanah dan air atau petugas pengendalian nyamuk.
`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
`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.