Representatives: representativeInfoByAddress

단일 주소에 대한 정치적 지리 및 대표 정보를 조회합니다. 지금 사용해 보기

요청

HTTP 요청

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

매개변수

매개변수 이름 값 설명
선택적 쿼리 매개변수
address string 조회할 주소입니다. URL에 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
        }
      ]
    }
  ]
}
속성 이름 값 설명 Notes
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인 경우에만 존재합니다. 자세한 내용은 대표자 리소스 문서를 참고하세요.

사용해 보기