Bộ sưu tập này bao gồm thông tin về vị trí địa lý chính trị, cũng như thông tin về các quan chức được bầu.
Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.
Biểu diễn tài nguyên
Tài nguyên trong bộ sưu tập này có ba phần, được mô tả chi tiết bên dưới. Phần divisions liệt kê các đơn vị phân chia địa lý chính trị, chẳng hạn như quốc gia, tiểu bang, hạt hoặc khu lập pháp. (Những bộ phận nào sẽ được liệt kê tuỳ thuộc vào yêu cầu API cụ thể được đưa ra.) Mục offices liệt kê các chức vụ chính trị được bầu để đại diện cho các bộ phận trong phần đầu tiên. Mục officials liệt kê những người hiện đang làm việc tại các văn phòng được liệt kê.
{
"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
}
]
}
]
}Địa lý chính trị
| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
divisions |
object |
Phân khu địa lý chính trị chứa địa chỉ được yêu cầu. | |
divisions.(key) |
nested object |
Giá trị nhận dạng Dữ liệu công dân mở duy nhất của đơn vị này. | |
divisions.(key).alsoKnownAs[] |
list |
Mọi mã OCD hợp lệ khác tham chiếu đến cùng một cách phân chia. Vì mã nhận dạng OCD là mã mà con người có thể đọc được và ít nhất là phần nào cũng dự đoán được, nên đôi khi cũng có một số giá trị nhận dạng cho một bộ phận. Các giá trị nhận dạng này được xác định là tương đương với nhau và một giá trị luôn được chỉ định là giá trị nhận dạng chính. Giá trị nhận dạng chính sẽ được trả về trong ocd_id ở trên và mọi giá trị nhận dạng hợp lệ tương đương khác sẽ được trả về trong danh sách này. Ví dụ: nếu mã OCD của đơn vị phân chia này là ocd-division/country:us/district:dc, thì mã này sẽ chứa ocd-division/country:us/state:dc. |
|
divisions.(key).name |
string |
Tên bộ phận. | |
divisions.(key).officeIndices[] |
list |
Danh sách các chỉ mục trong mảng offices, một chỉ mục cho mỗi chức vụ được chọn từ bộ phận này. Sẽ chỉ xuất hiện nếu includeOffices có giá trị true (hoặc không có) trong yêu cầu. |
Cơ quan bầu cử
| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
offices[] |
list |
Các chức vụ được bầu được dẫn chiếu đến các bộ phận nêu trên. Sẽ chỉ xuất hiện nếu includeOffices là có trong yêu cầu. | |
offices[].divisionId |
string |
Mã OCD của bộ phận có liên kết với văn phòng này. | |
offices[].levels[] |
list |
Các cấp chính phủ mà văn phòng này là thành viên. Có thể có nhiều trường hợp mà một khu vực tài phán hành động hiệu quả ở hai cấp chính phủ khác nhau; ví dụ: thị trưởng Đặc khu Columbia hành động tại "địa phương" mà còn hiệu quả ở cả administrativeArea2 và administrativeArea1.Các giá trị hợp lệ bao gồm:
|
|
offices[].name |
string |
Tên văn phòng mà con người có thể đọc được. | |
offices[].officialIndices[] |
list |
Danh sách các chỉ mục trong mảng quan chức của những người hiện đang giữ chức vụ này. | |
offices[].roles[] |
list |
Vai trò mà văn phòng này hoàn thành. Vai trò không phải là đầy đủ hoặc chỉ định chính xác toàn bộ trách nhiệm của một văn phòng nhất định mà chỉ là các danh mục gần đúng, có ích cho việc lựa chọn chung trong danh sách các chức vụ. Các giá trị hợp lệ bao gồm:
|
|
offices[].sources[] |
list |
Danh sách các nguồn thông tin cho văn phòng này. Nếu có nhiều nguồn được liệt kê, thì dữ liệu được tổng hợp từ các nguồn đó. | |
offices[].sources[].name |
string |
Tên của nguồn dữ liệu. | |
offices[].sources[].official |
boolean |
Liệu dữ liệu này có xuất phát từ một nguồn chính thức của chính phủ hay không. |
Quan chức được bầu
| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
officials[] |
list |
Quan chức có các văn phòng nêu trên. Sẽ chỉ xuất hiện nếu includeOffices là có trong yêu cầu. | |
officials[].address[] |
list |
Địa chỉ để liên hệ với nhân viên chính thức. | |
officials[].address[].city |
string |
Thành phố hoặc thị trấn đối với địa chỉ. | |
officials[].address[].line1 |
string |
Tên đường phố và số nhà của địa chỉ này. | |
officials[].address[].line2 |
string |
Dòng thứ hai ghi địa chỉ, nếu cần. | |
officials[].address[].line3 |
string |
Dòng thứ ba của địa chỉ, nếu cần. | |
officials[].address[].locationName |
string |
Tên của vị trí. | |
officials[].address[].state |
string |
Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ. | |
officials[].address[].zip |
string |
Mã bưu chính Hoa Kỳ của địa chỉ. | |
officials[].channels[] |
list |
Danh sách các kênh truyền thông (xã hội) đã biết của quan chức này. | |
officials[].channels[].id |
string |
Giá trị nhận dạng công khai duy nhất trên kênh của ứng cử viên. | |
officials[].channels[].type |
string |
Loại kênh. Dưới đây là danh sách các loại kênh nhưng chưa đầy đủ. Chúng tôi có thể thêm các loại kênh khác sau. Một trong các lựa chọn sau: YouTube, Facebook, Twitter | |
officials[].emails[] |
list |
Địa chỉ email trực tiếp của nhân viên. | |
officials[].name |
string |
Tên của quan chức đó. | |
officials[].party |
string |
Tên đầy đủ của đảng mà quan chức này sở hữu. | |
officials[].phones[] |
list |
Số điện thoại liên hệ công khai của quan chức này. | |
officials[].photoUrl |
string |
URL ảnh chụp quan chức đó. | |
officials[].urls[] |
list |
URL trang web công khai của quan chức này. |
Phương thức
- representativeInfoByAddress
- Tra cứu thông tin địa lý chính trị và thông tin đại diện để tìm một địa chỉ duy nhất.
- representativeInfoByDivision
- Tra cứu thông tin đại diện của một bộ phận địa lý.