Representatives

此集合包含有关政治地理位置以及民选官员的信息。

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

资源表示形式

此集合中的资源包含三个部分，下面将详细介绍。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一级执行操作。

有效值包括：
  • international - 国际政府，例如联合国或欧盟。
  • country -- 国家级政府，例如美国联邦政府。
  • administrativeArea1 - 国家/地区的顶级行政区划政府，例如美国各州。
  • regional - 地区政府的管辖区可能会与标准的行政区划有重叠；这类情况在美国并不常见，但在其他国家/地区的大城市中很常见。
  • administrativeArea2 - 一个国家/地区的二级行政区划政府，例如美国的县。
  • locality -- 市或市政府。
  • subLocality1 - 城市的顶级行政区划政府，如华盛顿特区的区。
  • subLocality2 -- 城市次级行政区划政府，例如华盛顿特区顾问邻里委员会。
  • special - 仅供特殊用途的政府设立的地方，例如土壤和水资源保护区。
offices[].name string 直观易懂的办公室名称。
offices[].officialIndices[] list 现任职务的官员阵容中指数列表。
offices[].roles[] list 此 Office 所担任的角色。职务并不是详尽无遗的，也不是详尽地说明指定办事处的全部职责，但只是粗略的类别，有助于对办事处进行一般选择或排序。

有效值包括：
  • 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
查找单个地理部门的代表性信息。