Representatives: representativeInfoByAddress

Tra cứu thông tin địa lý chính trị và thông tin đại diện cho một địa chỉ duy nhất. 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ị 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ể được chỉ định nếu trường ocdId không phải là đã cung cấp trong URL.
includeOffices boolean Có trả lại thông tin về văn phòng và quan chức hay không. Nếu sai, chỉ thông tin về học khu cấp cao nhất sẽ được trả về. (Mặc định: true)
levels string Danh sách các cấp văn phòng để lọc theo. Chỉ các văn phòng phục vụ ít nhất một trong các cấp độ này sẽ được trả về. Phần không chứa văn phòng phù hợp sẽ không được trả lại.

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

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

Nội dung yêu cầu

Đừ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ị 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ố nhà 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 thứ ba của địa chỉ, nếu cần.
normalizedInput.city string Thành phố hoặc thị trấn đối với địa chỉ.
normalizedInput.state string Tên viết tắt của địa chỉ gồm hai chữ cái tại Hoa Kỳ.
normalizedInput.zip string Mã bưu chính Hoa Kỳ của địa chỉ.
divisions object Phân khu địa lý chính trị có chứa thông tin được yêu cầu của bạn. Để biết thêm thông tin, hãy xem Đại diện tài nguyên của chúng tôi.
offices[] list Các chức vụ được bầu được dẫn chiếu đến các bộ phận nêu trên. Ý chí chỉ có mặt nếu includeOffices là đúng trong yêu cầu. Để biết thêm thông tin, hãy xem Đại diện tài nguyên của chúng tôi.
officials[] list Quan chức có các văn phòng nêu trên. Sẽ chỉ xuất hiện nếu includeOffices là đúng trong yêu cầu. Để biết thêm thông tin, hãy xem Đại diện tài nguyên của chúng tôi.

Hãy dùng thử!