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 필터링할 사무실 수준의 목록입니다. 최소 서비스 수준인 사무실만 이 수준 중 하나가 반환됩니다. 포함되지 않은 부서입니다. 일치하는 사무실은 반환되지 않습니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "administrativeArea1"
  • "administrativeArea2"
  • "country"
  • "international"
  • "locality"
  • "regional"
  • "special"
  • "subLocality1"
  • "subLocality2"
roles string 필터링할 사무실 역할 목록입니다. 다음 중 하나를 충족하는 사무실만 해당 역할이 반환됩니다 일치하는 부분이 없는 부서 반환되지 않습니다.

사용 가능한 값은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • "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 위에 명시된 사무실을 담당하는 공무원. 참석하기만 함 요청에 포함된 Office가 true였는지 확인합니다. 자세한 내용은 담당자는 리소스 문서를 참조하세요.

사용해 보기