Representatives: representativeInfoByAddress

查询单个地址的政治地理位置和代表性信息。 立即试用。

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

请求

HTTP 请求

GET https://www.googleapis.com/civicinfo/v2/representatives

参数

参数名称 值 说明
可选的查询参数
address string 要查找的地址。只有在字段 ocdId 未赋值时才能指定 。
includeOffices boolean 是否返回有关办公室和官员的信息。如果为 false，则仅 就会返回顶级学区信息。 （默认值：true）
levels string 要过滤的办公室层级列表。仅限至少提供服务的办事处 其中某个关卡将被返回。不包含 将不会返回匹配的办公室。

可接受的值包括：
  • “administrativeArea1”
  • “administrativeArea2”
  • “country”
  • “international”
  • “locality”
  • “regional”
  • “special”
  • “subLocality1”
  • “subLocality2”
roles string 要过滤的办公室角色列表。仅限满足以下任一条件的办事处 这些角色不包含匹配的部门 办公室不会归还。

可接受的值包括：
  • “deputyHeadOfGovernment”
  • “executiveCouncil”
  • “governmentOfficer”
  • “headOfGovernment”
  • “headOfState”
  • “highestCourtJudge”
  • “judge”
  • “legislatorLowerBody”
  • “legislatorUpperBody”
  • “schoolBoard”
  • “specialPurposeOfficer”

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "civicinfo#representativeInfoResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "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
        }
      ]
    }
  ]
}
属性名称 值 说明 备注
kind string 指明资源的类型。值：固定字符串 "civicinfo#representativeInfoResponse"。
normalizedInput nested object 所请求地址的标准化版本
normalizedInput.locationName string 位置的名称。
normalizedInput.line1 string 此地址的街道名称和门牌号。
normalizedInput.line2 string 第二行地址（如果需要）。
normalizedInput.line3 string 地址的第三行（如果需要）。
normalizedInput.city string 地址对应的城市或城镇。
normalizedInput.state string 地址的美国州名缩写，由两个字母组成。
normalizedInput.zip string 地址的美国邮政编码。
divisions object 包含请求的政治行政区划 地址。有关详情，请参阅 代表 资源文档。
offices[] list 上述分部提名的民选公职。威尔 仅当请求中的 includeOffices 为 true 时才显示。有关详情，请参阅 代表 资源文档。
officials[] list 以上所列办公室的任职官员。将只显示 如果请求中的 includeOffices 为 true，则会发生此错误。有关详情，请参阅 代表 资源文档。

试试看！