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 ตัวระบุข้อมูล Open 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 ของแผนกที่เชื่อมโยงกับสำนักงานนี้
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 บรรทัดที่สามของที่อยู่ หากจําเป็น
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
ค้นหาข้อมูลตัวแทนสำหรับส่วนย่อยทางภูมิศาสตร์เดียว