Representatives: 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ỉ. Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Tham số

Tên thông số Giá trị Nội dung mô tả
Tham số truy vấn không bắt buộc
address string Địa chỉ cần tra cứu. Chỉ có thể chỉ định nếu trường ocdId không được cung cấp trong URL.
includeOffices boolean Liệu có trả lại thông tin về văn phòng và quan chức hay không. Nếu giá trị là false, chỉ có thông tin về học khu cấp cao nhất được trả về. (Mặc định: true)
levels string Danh sách văn phòng để lọc theo. Hệ thống sẽ chỉ trả về những văn phòng phục vụ ít nhất một trong các cấp này. Những bộ phận không có văn phòng phù hợp sẽ không được trả về.

Các giá trị có thể chấp nhận là:
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string Danh sách vai trò văn phòng để lọc theo. Chỉ những văn phòng thực hiện một trong các vai trò này sẽ bị trả lại. Những bộ phận không có văn phòng phù hợp sẽ không được trả về.

Các giá trị có thể chấp nhận là:
  • "deputyHeadOfGovernment"
  • "executiveCouncil"
  • "governmentOfficer"
  • "headOfGovernment"
  • "headOfState"
  • "highestCourtJudge"
  • "judge"
  • "legislatorLowerBody"
  • "legislatorUpperBody"
  • "schoolBoard"
  • "specialPurposeOfficer"

Nội dung yêu cầu

Không cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:

{
  "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
        }
      ]
    }
  ]
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
kind string Xác định loại tài nguyên này. Giá trị: chuỗi cố định "civicinfo#representativeInfoResponse".
normalizedInput nested object Phiên bản chuẩn hoá của địa chỉ được yêu cầu
normalizedInput.locationName string Tên của vị trí.
normalizedInput.line1 string Tên đường phố và số của địa chỉ này.
normalizedInput.line2 string Dòng thứ hai ghi địa chỉ, nếu cần.
normalizedInput.line3 string Dòng địa chỉ thứ ba, nếu cần.
normalizedInput.city string Thành phố hoặc thị trấn của địa chỉ.
normalizedInput.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ỳ.
normalizedInput.zip string Mã bưu chính của Hoa Kỳ của địa chỉ.
divisions object Đơn vị địa lý chính trị có chứa địa chỉ được yêu cầu. Để biết thêm thông tin chi tiết, hãy xem tài liệu về Tài nguyên đại diện.
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. Để biết thêm thông tin chi tiết, hãy xem tài liệu về Tài nguyên đại diện.
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. Để biết thêm thông tin chi tiết, hãy xem tài liệu về Tài nguyên đại diện.

Hãy dùng thử!