此集合包含有关政治地理位置以及民选官员的信息。
有关此类资源的方法列表,请参阅本页面的结尾部分。
资源表示形式
此集合中的资源包含三个部分,下面将详细介绍。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 |
此部门的唯一开放公民数据标识符。 | |
divisions.(key).alsoKnownAs[] |
list |
引用同一部门的任何其他有效 OCD ID。 由于 OCD ID 旨在提供人类可读懂的,并且至少在一定程度上可预测,因此一个部门偶尔会有多个标识符。这些标识符彼此等效,且其中一个始终指定为主要标识符。主要标识符将在上面的 ocd_id 中返回,任何其他等效的有效标识符都将在此列表中返回。 例如,如果该部门的 OCD ID 是 ocd-division/country:us/district:dc,则它将包含 ocd-division/country:us/state:dc。 |
|
divisions.(key).name |
string |
部门的名称。 | |
divisions.(key).officeIndices[] |
list |
offices 数组中的索引列表,对应于从此部门选出的每个办事处。仅当请求中的 includeOffices 为 true(或不存在)时,此字段才会显示。 |
民选办公室
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
offices[] |
list |
上述部门引用的当选公职。仅当请求中的 includeOffices 为 true 时,才会显示。 | |
offices[].divisionId |
string |
此办公室相关联的部门的 OCD ID。 | |
offices[].levels[] |
list |
此办事处所属政府的级别。如果一个管辖区实际上是在两个不同级别的政府部门行事,一个管辖区可能会不止一个。例如,哥伦比亚特区的市长在“市行政区”级别行事,但实际上也是同时在administrativeArea2 和administrativeArea1 一级执行操作。有效值包括:
|
|
offices[].name |
string |
直观易懂的办公室名称。 | |
offices[].officialIndices[] |
list |
现任职务的官员阵容中指数列表。 | |
offices[].roles[] |
list |
此 Office 所担任的角色。职务并不是详尽无遗的,也不是详尽地说明指定办事处的全部职责,但只是粗略的类别,有助于对办事处进行一般选择或排序。 有效值包括:
|
|
offices[].sources[] |
list |
此办事处的来源列表。如果列出了多个来源,那么数据都是从这些来源汇总而来。 | |
offices[].sources[].name |
string |
数据源的名称。 | |
offices[].sources[].official |
boolean |
这些数据是否来自政府官方来源。 |
当选官员
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
officials[] |
list |
担任上述办公室的官员。仅当请求中的 includeOffices 为 true 时,才会显示。 | |
officials[].address[] |
list |
与官员联系的地址。 | |
officials[].address[].city |
string |
地址对应的城市或城镇。 | |
officials[].address[].line1 |
string |
此地址的街道名称和门牌号。 | |
officials[].address[].line2 |
string |
地址的第二行(如果需要)。 | |
officials[].address[].line3 |
string |
地址的第三行(如果需要)。 | |
officials[].address[].locationName |
string |
位置的名称。 | |
officials[].address[].state |
string |
地址对应的美国州名缩写,由两个字母组成。 | |
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 |
该官员的照片网址。 | |
officials[].urls[] |
list |
该官员的公开网站网址。 |
方法
- representativeInfoByAddress
- 查询单个地址的政治地理位置和代表性信息。
- representativeInfoByDivision
- 查找单个地理部门的代表性信息。