หน้านี้ได้รับการแปลโดย Cloud Translation API

Representatives

คอลเล็กชันนี้ประกอบด้วยข้อมูลเกี่ยวกับภูมิศาสตร์ทางการเมือง รวมถึงเจ้าหน้าที่ที่ได้รับเลือกตั้ง

ดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ที่ส่วนท้ายของหน้านี้

การนำเสนอทรัพยากร

แหล่งข้อมูลในคอลเล็กชันนี้มี 3 ส่วน ดังที่อธิบายโดยละเอียดด้านล่าง ส่วนdivisionsจะแสดงเขตทางภูมิศาสตร์ทางการเมือง เช่น ประเทศ รัฐ เขต หรือเขตนิติบัญญัติ (แผนกที่จะแสดงรายการขึ้นอยู่กับคำขอ API ที่ระบุ) ส่วนofficesจะแสดงตำแหน่งทางการเมืองที่ได้รับการเลือกตั้งให้เป็นตัวแทนของพรรคต่างๆ ในส่วนแรก ส่วนofficialsจะแสดงรายชื่อผู้ที่ให้บริการในปัจจุบันในสำนักงานที่ระบุไว้

{
  "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
        }
      ]
    }
  ]
}

ภูมิศาสตร์การเมือง

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย
`divisions`	`object`	หน่วยงานทางภูมิศาสตร์ทางการเมืองที่มีที่อยู่ที่ขอ
`divisions.(key)`	`nested object`	ตัวระบุข้อมูล Civic แบบเปิดที่ไม่ซ้ำกันสำหรับแผนกนี้
`divisions.(key).alsoKnownAs[]`	`list`	รหัส OCD อื่นๆ ที่ถูกต้องซึ่งอ้างอิงถึงการหารเดียวกัน เนื่องจากรหัส OCD ต้องให้มนุษย์อ่านได้และคาดการณ์ได้ค่อนข้างน้อย ในบางครั้งจึงมีตัวระบุหลายตัวสำหรับการหารกลุ่มเดียว ตัวระบุเหล่านี้ได้รับการกำหนดให้เทียบเท่ากับตัวระบุอื่น และตัวระบุหนึ่งจะระบุเป็นตัวระบุหลักเสมอ ระบบจะส่งคืนตัวระบุหลักใน ocd_id ด้านบน และตัวระบุอื่นๆ ที่ใช้ได้ที่เทียบเท่าจะแสดงในรายการนี้ เช่น หาก OCD ของแผนกนี้คือ ocd-division/country:us/district:dc รหัสจะมี ocd-division/country:us/state:dc
`divisions.(key).name`	`string`	ชื่อของแผนก
`divisions.(key).officeIndices[]`	`list`	รายชื่อดัชนีในอาร์เรย์ `offices` หนึ่งรายการสำหรับแต่ละสำนักงานที่เลือกจากแผนกนี้ จะปรากฏก็ต่อเมื่อ `includeOffices` เป็นจริง (หรือไม่มีอยู่) ในคำขอ

สำนักงานเลือกตั้ง

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย
`offices[]`	`list`	ตำแหน่งที่ได้รับเลือกตั้งที่อ้างอิงโดยหน่วยงานที่ระบุไว้ข้างต้น จะปรากฏก็ต่อเมื่อ includeOffices เป็นจริงในคำขอเท่านั้น
`offices[].divisionId`	`string`	OCD ID ของแผนกที่เชื่อมโยงกับสำนักงานนี้
`offices[].levels[]`	`list`	ระดับรัฐบาลที่สำนักงานนี้เป็นสมาชิก อย่างไรก็ตาม อาจมีมากกว่า 1 ในกรณีในกรณีที่เขตอำนาจศาลทำหน้าที่ได้อย่างมีประสิทธิภาพใน 2 ระดับของรัฐบาลที่แตกต่างกัน ตัวอย่างเช่น นายกเทศมนตรีของดิสตริกต์ออฟโคลัมเบียทำหน้าที่ในระดับ "ท้องถิ่น" แต่ก็มีผลทั้งในระดับ `administrativeArea2` และ `administrativeArea1` ค่าที่ถูกต้อง ได้แก่ `international` -- รัฐบาลระหว่างประเทศ เช่น สหประชาชาติหรือสหภาพยุโรป `country` -- รัฐบาลระดับชาติ เช่น รัฐบาลสหพันธรัฐของสหรัฐอเมริกา `administrativeArea1` -- รัฐบาลของเขตการปกครองระดับสูงของประเทศ เช่น รัฐในสหรัฐอเมริกา `regional` -- รัฐบาลระดับภูมิภาคที่มีเขตอำนาจศาลอาจข้ามเขตการปกครองมาตรฐานได้ รัฐบาลเหล่านี้เป็นเรื่องปกติในสหรัฐอเมริกา แต่พบได้ทั่วไปในเมืองใหญ่ๆ ในประเทศอื่นๆ `administrativeArea2` -- รัฐบาลของเขตการปกครองระดับ 2 ของประเทศ เช่น เคาน์ตีในสหรัฐอเมริกา `locality` -- รัฐบาลระดับเมืองหรือเทศบาล `subLocality1` -- รัฐบาลของเขตการปกครองระดับบนสุดของเมือง เช่น เขตการปกครองของวอชิงตัน ดี.ซี. `subLocality2` -- รัฐบาลของหน่วยงานย่อยด้านการปกครองระดับ 2 ของเมือง เช่น สภาผู้นำทางความคิดของวอชิงตัน ดี.ซี. `special` -- เขตในท้องถิ่นที่สร้างขึ้นสำหรับหน่วยงานปกครองที่มีวัตถุประสงค์พิเศษเท่านั้น เช่น เขตอนุรักษ์ดินและน้ำ
`offices[].name`	`string`	ชื่อสำนักงานที่มนุษย์อ่านได้
`offices[].officialIndices[]`	`list`	รายชื่อดัชนีในกลุ่มเจ้าหน้าที่รัฐซึ่งดำรงตำแหน่งนี้ในปัจจุบัน
`offices[].roles[]`	`list`	บทบาทที่สำนักงานนี้ดำเนินการ บทบาทไม่ได้มีไว้โดยสังเขป หรือระบุความรับผิดชอบทั้งหมดของสำนักงานนั้นๆ แต่เป็นหมวดหมู่คร่าวๆ ที่มีประโยชน์สำหรับการเลือกหรือจัดเรียงรายชื่อสำนักงานทั่วไป ค่าที่ใช้ได้ ได้แก่ `headOfState` -- หัวหน้าตัวแทนสาธารณะของรัฐบาล โดยทั่วไปประมุขแห่งรัฐของประเทศหนึ่งจะเรียกว่าประธานาธิบดี `headOfGovernment` -- ประธานเจ้าหน้าที่บริหารของรัฐบาล ในสหรัฐอเมริกา บุคคลนี้คือประธานาธิบดี ส่วนประเทศอื่นๆ มักจะเป็นนายกรัฐมนตรี ส่วนในระดับที่ต่ำกว่านี้อาจเป็นผู้ว่าการรัฐหรือนายกเทศมนตรี `deputyHeadOfGovernment` -- เจ้าหน้าที่ผู้รับผิดชอบการดำรงตำแหน่งหัวหน้ารัฐบาลในเหตุการณ์การเสียชีวิตหรือไม่สามารถดำรงตำแหน่งหัวหน้ารัฐบาลที่ได้รับเลือกตั้งได้ รองประธานาธิบดีในสหรัฐอเมริกา สำนักงานนี้อาจมีหน้าที่อื่นด้วย `governmentOfficer` -- เจ้าหน้าที่สาขาที่ได้รับการเลือกตั้ง ในรัฐในสหรัฐอเมริกา บทบาทนี้อาจรวมถึงบทบาทต่างๆ เช่น อัยการสูงสุด ทนายกฏหมาย เลขาธิการหรือรัฐ หรือเหรัญญิก `executiveCouncil` -- เป็นสมาชิกของคณะกรรมการบริหารที่ปฏิบัติหน้าที่ตามบทบาทระดับผู้บริหารสาขาในนามของกลุ่ม ตัวอย่างเช่น กรรมาธิการมณฑลในรัฐอินดีแอนา `legislatorUpperBody` -- เป็นสมาชิกสภาฝ่ายบนของสภานิติบัญญัติที่มีสมาชิก 2 ฝ่าย หรือเป็นสมาชิกฝ่ายเดียวของสภานิติบัญญัติที่มีเพียงฝ่ายเดียว `legislatorLowerBody` -- เป็นสมาชิกสภานิติบัญญัติระดับล่างของสภานิติบัญญัติ 2 ฝ่าย `highestCourtJudge` -- ผู้พิพากษาของศาลชั้นต้นของรัฐบาลฝ่ายหนึ่ง เช่น ศาลฎีกาประจำรัฐ `judge` -- ผู้พิพากษาในศาลใดๆ ที่ไม่ใช่ศาลสูงสุดของรัฐบาลที่หน่วยงานนั้นให้บริการ `schoolBoard` -- สมาชิกของคณะกรรมการโรงเรียนในท้องถิ่น `specialPurposeOfficer` -- เจ้าหน้าที่ที่ทำหน้าที่ตามวัตถุประสงค์เดียวที่กำหนดไว้ เช่น เป็นสมาชิกคณะกรรมการอนุรักษ์ดินและน้ำ หรือเจ้าหน้าที่ป้องกันยุง
`offices[].sources[]`	`list`	รายการแหล่งที่มาของสำนักงานนี้ หากมีแหล่งที่มาหลายแหล่งอยู่ในรายการ แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
`offices[].sources[].name`	`string`	ชื่อของแหล่งข้อมูล
`offices[].sources[].official`	`boolean`	ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่

เจ้าหน้าที่รัฐที่ได้รับเลือก

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย
`officials[]`	`list`	เจ้าหน้าที่ผู้ดำรงตำแหน่งราชการที่ระบุไว้ข้างต้น จะปรากฏก็ต่อเมื่อ includeOffices เป็นจริงในคำขอเท่านั้น
`officials[].address[]`	`list`	ที่อยู่สำหรับติดต่อเจ้าหน้าที่
`officials[].address[].city`	`string`	เมืองสำหรับที่อยู่
`officials[].address[].line1`	`string`	ชื่อถนนและเลขที่ของที่อยู่นี้
`officials[].address[].line2`	`string`	บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
`officials[].address[].line3`	`string`	บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
`officials[].address[].locationName`	`string`	ชื่อของสถานที่ตั้ง
`officials[].address[].state`	`string`	อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
`officials[].address[].zip`	`string`	รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
`officials[].channels[]`	`list`	รายชื่อช่องโซเชียลมีเดียที่รู้จักสำหรับเจ้าหน้าที่รายนี้
`officials[].channels[].id`	`string`	ตัวระบุสาธารณะที่ไม่ซ้ำกันสำหรับช่องของผู้สมัคร
`officials[].channels[].type`	`string`	ประเภทของช่อง ประเภทช่องมีดังนี้ โดยเราจะเพิ่มช่องประเภทอื่นๆ ในภายหลัง ข้อใดข้อหนึ่ง: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	อีเมลโดยตรงของเจ้าหน้าที่คนดังกล่าว
`officials[].name`	`string`	ชื่อทางการ
`officials[].party`	`string`	ชื่อและนามสกุลของบุคคลที่เจ้าหน้าที่สังกัดอยู่
`officials[].phones[]`	`list`	หมายเลขโทรศัพท์ติดต่อสาธารณะของเจ้าหน้าที่คนดังกล่าว
`officials[].photoUrl`	`string`	URL สำหรับรูปภาพของเจ้าหน้าที่รัฐ
`officials[].urls[]`	`list`	URL ของเว็บไซต์สาธารณะของทางการ

วิธีการ

representativeInfoByAddress: ค้นหาภูมิศาสตร์ทางการเมืองและข้อมูลตัวแทนสำหรับที่อยู่เดียว
representativeInfoByDivision: ค้นหาข้อมูลตัวแทนสำหรับการแบ่งแยกทางภูมิศาสตร์หนึ่งๆ