Representatives

此集合包含有关政治地理和民选官员的信息。

有关此类资源的方法列表，请参阅本页面的结尾部分。

<ph type="x-smartling-placeholder">

资源表示形式

此集合中的资源包含三个部分，下文对此进行了详细介绍。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 Data 标识符。
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 上也有效。

有效值包括：
  • international - 国际政府（如联合国或欧盟）。
  • country -- 国家级政府，例如美国联邦政府。
  • administrativeArea1 - 一个国家/地区的顶级行政分区（如美国各州）的政府。
  • regional -- 其管辖区设有标准行政分区的地区政府；这类数据在美国并不常见，但在其他国家/地区的大城市比较常见。
  • administrativeArea2 - 一个国家/地区的二级行政分区政府，例如美国各县。
  • locality - 市政府或市政府。
  • subLocality1 -- 城市的顶级行政分区（例如华盛顿特区的区）的政府。
  • subLocality2 -- 城市的二级行政分区政府，如华盛顿特区咨询社区委员会。
  • special - 仅用于特殊用途的政府（例如水资源保护区）的本地区。
offices[].name string 直观易懂的办事处名称。
offices[].officialIndices[] list 官员中目前担任此职务的人员的索引列表。
offices[].roles[] list 此办事处担任的角色。角色并不是详尽无遗的，也不能确切规定指定办事处的全部职责，而是大致的类别，有助于从一系列办事处进行常规选择或对其进行排序。

有效值包括：
  • headOfState -- 政府的首席公共代表。一个国家元首通常称为总统。
  • headOfGovernment - 政府的首席执行官。在美国，也就是“总统”；而其他国家/地区则通常为首相。在较低级别，此人可能是州长或市长。
  • deputyHeadOfGovernment：在当选政府首脑死亡或无能时，负责担任政府首脑的官员。在美国，我是副总裁此办公室可能还有其他职责。
  • governmentOfficer - 民选行政部门官员。在美国各州，这可能包括总检察长、秘书或州或财务主管等职位。
  • executiveCouncil - 担任行政部门职能的行政委员会成员。例如印第安纳州县长。
  • legislatorUpperBody -- 两院立法机构的上层成员，或单院议院的唯一立法机构。
  • legislatorLowerBody -- 两院立法机构下属成员。
  • highestCourtJudge - 特定政府最高法院（例如州最高法院）的法官。
  • judge -- 在其所任职的政府最高法院以外的任何法院的法官。
  • schoolBoard -- 当地学校董事会成员。
  • specialPurposeOfficer -- 为实现单一、明确目的而提供服务的官员，如水土资源保护委员会成员或蚊虫防治工作人员。
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
查找单个地理区域的代表性信息。