Halaman ini diterjemahkan oleh Cloud Translation API.

Representatives

Kumpulan ini mencakup informasi tentang geografi politik, serta pejabat terpilih.

Untuk 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 divisi di bagian pertama. Bagian officials mencantumkan orang-orang yang saat ini bekerja di kantor-kantor yang terdaftar.

{
  "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`	Pembagian geografis politik yang berisi alamat yang diminta.
`divisions.(key)`	`nested object`	ID Data Civic Terbuka unik untuk divisi ini.
`divisions.(key).alsoKnownAs[]`	`list`	ID OCD valid lainnya yang merujuk pada divisi yang sama. Karena ID OCD dimaksudkan agar dapat dibaca manusia dan setidaknya dapat diprediksi, terkadang ada beberapa ID untuk satu divisi. ID ini ditetapkan setara dengan satu sama lain, dan satu ID selalu ditunjukkan 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, maka ID ini akan berisi ocd-division/country:us/state:dc.
`divisions.(key).name`	`string`	Nama pembagian.
`divisions.(key).officeIndices[]`	`list`	Daftar indeks dalam array `offices`, satu untuk setiap jabatan yang dipilih dari divisi ini. Hanya akan ada jika `includeOffices` bernilai 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 benar dalam permintaan.
`offices[].divisionId`	`string`	ID OCD divisi yang terkait dengan kantor ini.
`offices[].levels[]`	`list`	Tingkat pemerintahan yang menggunakan kantor ini. Mungkin ada lebih dari satu kasus di mana wilayah hukum secara efektif bertindak di dua tingkat pemerintahan yang berbeda; misalnya, wali kota District of Columbia bertindak di "lokalitas" tetapi juga efektif di `administrativeArea2` dan `administrativeArea1`. Nilai yang valid mencakup: `international` -- Pemerintah internasional, seperti Perserikatan Bangsa-Bangsa atau Uni Eropa. `country` -- Pemerintah tingkat nasional, seperti Pemerintah Federal AS. `administrativeArea1` -- Pemerintah subdivisi administratif tingkat teratas suatu negara, seperti negara bagian AS. `regional` -- Pemerintah regional yang wilayah hukumnya dapat melintasi subdivisi administratif standar; ini jarang terjadi di AS tetapi umum terjadi di sekitar kota-kota besar di negara lain. `administrativeArea2` -- Pemerintah subdivisi administratif tingkat kedua suatu negara, seperti county AS. `locality` -- Pemerintah kota atau kota madya. `subLocality1` -- Pemerintah subdivisi administratif tingkat teratas kota, seperti distrik Washington, DC. `subLocality2` -- Pemerintah subdivisi administratif tingkat kedua sebuah kota,seperti Advisory Neighborhood Councils 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 susunan pejabat yang saat ini memegang jabatan ini.
`offices[].roles[]`	`list`	Peran-peran yang dijalankan kantor ini. Peran tidak dimaksudkan bersifat menyeluruh, atau untuk secara tepat menentukan keseluruhan tanggung jawab kantor tertentu, tetapi dimaksudkan sebagai kategori kasar yang berguna untuk pemilihan umum dari atau pengurutan daftar kantor. Nilai yang valid mencakup: `headOfState` -- Kepala perwakilan publik dari suatu pemerintah. Kepala negara biasanya disebut Presiden. `headOfGovernment` -- Kepala eksekutif pemerintah. Di AS, ini adalah Presiden; di negara lain, seringkali adalah Perdana Menteri. Pada tingkat yang lebih rendah, jabatan tersebut dapat berupa gubernur atau wali kota. `deputyHeadOfGovernment` -- Pejabat yang bertanggung jawab untuk memegang peran kepala pemerintahan jika kepala pemerintahan terpilih meninggal atau tidak terpilih. Di AS, ini adalah Wakil Presiden. Kantor ini mungkin juga memiliki tugas lain. `governmentOfficer` -- Petugas cabang eksekutif terpilih. Di negara bagian Amerika Serikat, peran ini dapat mencakup peran seperti jaksa umum, pengawas, sekretaris atau negara bagian, atau bendahara. `executiveCouncil` -- Anggota dewan eksekutif yang menjalankan peran cabang eksekutif sebagai grup. Contohnya termasuk komisaris county Indiana. `legislatorUpperBody` -- Anggota badan atas legislatif bikameral, atau satu-satunya badan legislatif satu kameral. `legislatorLowerBody` -- Anggota badan bawah legislatif bikameral. `highestCourtJudge` -- Hakim pengadilan tinggi pemerintah tertentu, seperti Mahkamah Agung negara bagian. `judge` -- Hakim di pengadilan mana pun yang bukan pengadilan tertinggi dari pemerintah yang dilayaninya. `schoolBoard` -- Anggota dewan sekolah setempat. `specialPurposeOfficer` -- Petugas yang melayani satu tujuan yang telah ditetapkan, 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 digabungkan dari 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 benar dalam permintaan.
`officials[].address[]`	`list`	Alamat yang dapat digunakan untuk menghubungi pejabat tersebut.
`officials[].address[].city`	`string`	Kota untuk alamat.
`officials[].address[].line1`	`string`	Nama dan nomor jalan untuk alamat ini.
`officials[].address[].line2`	`string`	Baris kedua alamat, jika diperlukan.
`officials[].address[].line3`	`string`	Baris ketiga alamat, jika diperlukan.
`officials[].address[].locationName`	`string`	Nama lokasi.
`officials[].address[].state`	`string`	Singkatan negara bagian AS yang terdiri dari dua huruf.
`officials[].address[].zip`	`string`	Kode Pos Amerika Serikat untuk alamat.
`officials[].channels[]`	`list`	Daftar saluran media (sosial) yang diketahui untuk pejabat ini.
`officials[].channels[].id`	`string`	ID publik unik untuk channel kandidat.
`officials[].channels[].type`	`string`	Jenis channel. Berikut adalah daftar jenis channel, tetapi tidak lengkap. Jenis saluran lainnya dapat ditambahkan nanti. Salah satu dari: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	Alamat email langsung untuk pejabat tersebut.
`officials[].name`	`string`	Nama pejabat.
`officials[].party`	`string`	Nama lengkap pihak yang dimiliki pejabat tersebut.
`officials[].phones[]`	`list`	Nomor telepon kontak publik milik pejabat tersebut.
`officials[].photoUrl`	`string`	URL untuk foto pejabat tersebut.
`officials[].urls[]`	`list`	URL situs publik milik pejabat tersebut.

Metode

representativeInfoByAddress: Mencari informasi geografi dan perwakilan politik untuk satu alamat.
representativeInfoByDivision: Mencari informasi representatif untuk satu divisi geografis.