Bộ sưu tập này bao gồm thông tin về địa lý chính trị, cũng như các quan chức được bầu.
Để biết danh sách các phương thức của tài nguyên này, hãy xem ở cuối trang này.
Biểu thị tài nguyên
Tài nguyên trong bộ sưu tập này có 3 phần được mô tả chi tiết ở bên dưới. Phần divisions liệt kê các đơn vị đị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 thực hiện.) Phần offices liệt kê các vị trí chính trị được bầu để đại diện cho đơn vị trong phần đầu tiên. Mục officials liệt kê những người hiện đang làm việc trong 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ị | Nội dung mô tả | Ghi chú |
|---|---|---|---|
divisions |
object |
Đơn vị địa lý chính trị có chứa địa chỉ được yêu cầu. | |
divisions.(key) |
nested object |
Mã nhận dạng duy nhất của Dữ liệu dân sự mở cho bộ phận này. | |
divisions.(key).alsoKnownAs[] |
list |
Mọi mã OCD hợp lệ khác tham chiếu đến cùng bộ phận phân chia. Vì mã OCD là mã dễ đọc và ít nhất là dễ dự đoán được, nên đôi khi sẽ 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 biểu thị 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 bộ phận 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 của bộ phận. | |
divisions.(key).officeIndices[] |
list |
Danh sách các chỉ mục trong mảng offices, mỗi chỉ mục cho mỗi văn phòng được chọn từ bộ phận này. Sẽ chỉ xuất hiện nếu includeOffices đúng (hoặc không có) trong yêu cầu. |
Văn phòng được bầu
| Tên tài sản | Giá trị | Nội dung mô tả | Ghi chú |
|---|---|---|---|
offices[] |
list |
Chức vụ được bầu theo các phòng ban nêu trên. Sẽ chỉ xuất hiện nếu includeOffices đúng 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ủ có liên quan đến văn phòng này. Trong trường hợp một khu vực tài phán có thể có nhiều hành động hiệu quả ở hai cấp chính quyền khác nhau; ví dụ: thị trưởng Quận Columbia hành động ở cấp "địa phương" nhưng cũng có hiệu lực ở 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 mục trong danh sách quan chức gồm những người hiện đang giữ chức vụ này. | |
offices[].roles[] |
list |
Những vai trò mà văn phòng này đảm nhận. Vai trò không phải là một chức năng đầy đủ hoặc để xác định chính xác toàn bộ trách nhiệm của một văn phòng cụ thể, mà chỉ là những danh mục sơ bộ giúp bạn dễ dàng lựa chọn hoặc sắp xếp danh sách văn phòng. Các giá trị hợp lệ bao gồm:
|
|
offices[].sources[] |
list |
Danh sách các nguồn của văn phòng này. Nếu có nhiều nguồn, 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ừ 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ị | Nội dung mô tả | Ghi chú |
|---|---|---|---|
officials[] |
list |
Các quan chức giữ các văn phòng được liệt kê ở trên. Sẽ chỉ xuất hiện nếu includeOffices đúng trong yêu cầu. | |
officials[].address[] |
list |
Địa chỉ để liên hệ với công chức. | |
officials[].address[].city |
string |
Thành phố hoặc thị trấn của địa chỉ. | |
officials[].address[].line1 |
string |
Tên đường phố và số 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 địa chỉ thứ ba, 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ỉ theo tiểu bang gồm hai chữ cái của Hoa Kỳ. | |
officials[].address[].zip |
string |
Mã bưu chính của 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 cho 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 công chức. | |
officials[].name |
string |
Tên của công chức đó. | |
officials[].party |
string |
Tên đầy đủ của bên có quan chức đó. | |
officials[].phones[] |
list |
Số điện thoại liên hệ công khai của quan chức đó. | |
officials[].photoUrl |
string |
URL ảnh của quan chức đó. | |
officials[].urls[] |
list |
URL trang web công khai của công chức đó. |
Phương thức
- representativeInfoByAddress
- Tra cứu thông tin về địa lý chính trị và thông tin đại diện cho một địa chỉ.
- representativeInfoByDivision
- Tra cứu thông tin đại diện cho một bộ phận địa lý.