คอลเล็กชันนี้ประกอบด้วยข้อมูลเกี่ยวกับภูมิศาสตร์ทางการเมือง รวมถึงเจ้าหน้าที่ที่ได้รับเลือกตั้ง
ดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ที่ส่วนท้ายของหน้านี้
การนำเสนอทรัพยากร
แหล่งข้อมูลในคอลเล็กชันนี้มี 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 } ] } ] }
ภูมิศาสตร์การเมือง
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
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 เป็นจริง (หรือไม่มีอยู่) ในคำขอ |
สำนักงานเลือกตั้ง
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
offices[] |
list |
ตำแหน่งที่ได้รับเลือกตั้งที่อ้างอิงโดยหน่วยงานที่ระบุไว้ข้างต้น จะปรากฏก็ต่อเมื่อ includeOffices เป็นจริงในคำขอเท่านั้น | |
offices[].divisionId |
string |
OCD ID ของแผนกที่เชื่อมโยงกับสำนักงานนี้ | |
offices[].levels[] |
list |
ระดับรัฐบาลที่สำนักงานนี้เป็นสมาชิก อย่างไรก็ตาม อาจมีมากกว่า 1 ในกรณีในกรณีที่เขตอำนาจศาลทำหน้าที่ได้อย่างมีประสิทธิภาพใน 2 ระดับของรัฐบาลที่แตกต่างกัน ตัวอย่างเช่น นายกเทศมนตรีของดิสตริกต์ออฟโคลัมเบียทำหน้าที่ในระดับ "ท้องถิ่น" แต่ก็มีผลทั้งในระดับ administrativeArea2 และ administrativeArea1 ค่าที่ถูกต้อง ได้แก่
|
|
offices[].name |
string |
ชื่อสำนักงานที่มนุษย์อ่านได้ | |
offices[].officialIndices[] |
list |
รายชื่อดัชนีในกลุ่มเจ้าหน้าที่รัฐซึ่งดำรงตำแหน่งนี้ในปัจจุบัน | |
offices[].roles[] |
list |
บทบาทที่สำนักงานนี้ดำเนินการ บทบาทไม่ได้มีไว้โดยสังเขป หรือระบุความรับผิดชอบทั้งหมดของสำนักงานนั้นๆ แต่เป็นหมวดหมู่คร่าวๆ ที่มีประโยชน์สำหรับการเลือกหรือจัดเรียงรายชื่อสำนักงานทั่วไป ค่าที่ใช้ได้ ได้แก่
|
|
offices[].sources[] |
list |
รายการแหล่งที่มาของสำนักงานนี้ หากมีแหล่งที่มาหลายแหล่งอยู่ในรายการ แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น | |
offices[].sources[].name |
string |
ชื่อของแหล่งข้อมูล | |
offices[].sources[].official |
boolean |
ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่ |
เจ้าหน้าที่รัฐที่ได้รับเลือก
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
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
- ค้นหาข้อมูลตัวแทนสำหรับการแบ่งแยกทางภูมิศาสตร์หนึ่งๆ