단일 주소에 대한 정치적 지리 및 대표 정보를 조회합니다. 지금 사용해 보기
요청
HTTP 요청
GET https://www.googleapis.com/civicinfo/v2/representatives
매개변수
매개변수 이름 | 값 | 설명 |
---|---|---|
선택적 쿼리 매개변수 | ||
address |
string |
조회할 주소입니다. URL에 ocdId 필드가 제공되지 않은 경우에만 지정할 수 있습니다. |
includeOffices |
boolean |
사무실 및 공무원에 대한 정보의 반환 여부입니다. false인 경우 최상위 선거구 정보만 반환됩니다.
(기본값: true )
|
levels |
string |
필터링할 사무실 수준 목록입니다. 이 층 중 하나 이상에 해당하는 사무소만 반환됩니다. 일치하는 사무실이 없는 부서는 반환되지 않습니다.
허용되는 값은 다음과 같습니다.
|
roles |
string |
필터링할 사무실 역할 목록입니다. 이러한 역할 중 하나를 수행하는
사무실만 반환됩니다. 일치하는 사무실이 없는 부서는 반환되지 않습니다.
허용되는 값은 다음과 같습니다.
|
요청 본문
이 메소드를 사용할 때는 요청 본문을 제공하지 마세요.
응답
요청에 성공할 경우 이 메소드는 다음과 같은 구조의 응답 본문을 반환합니다.
{ "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인 경우에만 존재합니다. 자세한 내용은 대표자 리소스 문서를 참고하세요. |