คอลเล็กชันนี้มีข้อมูลเกี่ยวกับภูมิศาสตร์ทางการเมือง รวมถึงเจ้าหน้าที่ที่ได้รับเลือกตั้ง
ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
แหล่งข้อมูลในคอลเล็กชันนี้มี 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 ด้วยค่าที่ถูกต้องประกอบด้วย
|
|
offices[].name |
string |
ชื่อสำนักงานที่มนุษย์อ่านได้ | |
offices[].officialIndices[] |
list |
รายชื่อดัชนีในรายชื่อบุคคลของเจ้าหน้าที่ที่ดำรงตำแหน่งนี้ในปัจจุบัน | |
offices[].roles[] |
list |
บทบาทที่สำนักงานนี้ดำเนินการ บทบาทไม่ได้มีเจตนาให้ละเอียดถี่ถ้วนหรือเจาะจงหน้าที่รับผิดชอบทั้งหมดของสำนักงานหนึ่งๆ แต่หมายถึงหมวดหมู่คร่าวๆ ที่มีประโยชน์ต่อการเลือกหรือจัดเรียงรายชื่อสำนักงานโดยทั่วไป ค่าที่ถูกต้องประกอบด้วย
|
|
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
- ค้นหาข้อมูลตัวแทนสำหรับส่วนย่อยทางภูมิศาสตร์เดียว