이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Representatives

이 컬렉션에는 선출직 공무원뿐만 아니라 정치적 지리적 위치에 대한 정보가 포함됩니다.

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

이 컬렉션의 리소스에는 아래에 자세히 설명된 세 개의 섹션이 있습니다. divisions 섹션에는 국가, 주, 카운티, 입법 선거구와 같은 정치적 지리적 구분이 나열됩니다. (표시될 부서는 특정 API 요청에 따라 다릅니다.) offices 섹션에는 첫 번째 섹션에서 선거구를 대표하기 위해 선출된 정치적 입장이 나열됩니다. officials 섹션에는 목록에 있는 사무실에서 현재 근무 중인 사람들이 나열됩니다.

{
  "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
        }
      ]
    }
  ]
}

정치지리학

속성 이름	값	설명
`divisions`	`object`	요청된 주소가 포함된 행정구역입니다.
`divisions.(key)`	`nested object`	이 구획의 고유한 Open Civic Data 식별자입니다.
`divisions.(key).alsoKnownAs[]`	`list`	동일한 부서를 참조하는 다른 유효한 OCD ID OCD ID는 사람이 읽을 수 있고 최소한 어느 정도 예측 가능해야 하므로 단일 구분에 여러 식별자가 있는 경우가 있습니다. 이러한 식별자는 서로 동등한 것으로 정의되며, 그중 하나가 항상 기본 식별자로 표시됩니다. 기본 식별자는 위의 ocd_id에 반환되며 동등한 기타 유효한 식별자는 이 목록에 반환됩니다. 예를 들어 이 부서의 OCD ID가 ocd-division/country:us/district:dc인 경우 여기에는 ocd-division/country:us/state:dc가 포함됩니다.
`divisions.(key).name`	`string`	부서 이름입니다.
`divisions.(key).officeIndices[]`	`list`	`offices` 배열의 색인 목록으로, 이 부서에서 선출된 각 직책의 색인입니다. 요청에 `includeOffices`가 참 (또는 부재)인 경우에만 존재합니다.

선출직

속성 이름	값	설명
`offices[]`	`list`	위에 나열된 부서에서 참조하는 선출직 공직자입니다. 요청에서 includeOffices가 true인 경우에만 존재합니다.
`offices[].divisionId`	`string`	이 사무소와 관련된 부서의 OCD ID입니다.
`offices[].levels[]`	`list`	이 사무소가 속한 정부 수준입니다. 관할권이 두 개의 다른 수준의 정부에서 효과적으로 활동하는 경우 두 개 이상이 될 수 있습니다. 예를 들어 컬럼비아 특별구 시장은 '지역' 수준에서 활동하지만 `administrativeArea2` 및 `administrativeArea1` 모두에서 효력을 발휘합니다. 유효한 값은 다음과 같습니다. `international` -- UN이나 유럽 연합과 같은 국제 정부입니다. `country` -- 미국 연방 정부와 같은 국가 정부 기관입니다. `administrativeArea1` - 미국의 주와 같이 국가의 최상위 행정 구역 단위 정부입니다. `regional` -- 표준 행정 구역을 교차할 수 있는 지역 정부로, 미국에서는 드물지만 다른 국가의 대도시에서는 일반적입니다. `administrativeArea2` - 미국의 카운티와 같은 국가의 2차 행정구역 정부입니다. `locality` - 시 또는 지방 자치 정부. `subLocality1` -- 워싱턴 DC의 군과 같이 시의 최상위 행정 구역 행정구역 정부입니다. `subLocality2` -- 워싱턴 DC의 자문 지역 의회와 같은 도시의 2차 행정 행정구역 정부입니다. `special` - 토양 및 물 보존 지구와 같이 특수 목적의 정부용으로만 존재하는 지역 지구입니다.
`offices[].name`	`string`	사람이 읽을 수 있는 사무실 이름입니다.
`offices[].officialIndices[]`	`list`	현재 이 직책을 맡고 있는 공무원 배열의 지수 목록입니다.
`offices[].roles[]`	`list`	이 사무소에서 수행하는 역할입니다. 역할은 모든 직책을 포괄하거나 특정 직책의 전체 책임을 정확히 지정하기 위한 것이 아니라, 사무실 목록에서 일반적으로 선택하거나 정렬하는 데 유용한 대략적인 카테고리입니다. 유효한 값은 다음과 같습니다. `headOfState` -- 정부의 최고 공공 대리인. 국가의 원수는 보통 대통령이라고 합니다. `headOfGovernment` - 정부의 최고경영자입니다. 미국에서는 대통령, 다른 국가에서는 총리인 경우가 많습니다. 하위 수준에서는 주지사 또는 시장이 될 수 있습니다. `deputyHeadOfGovernment` - 선출된 정부 원수가 사망하거나 실직 상태가 발생할 경우 정부 수반의 역할을 맡을 책임이 있는 공무원입니다. 미국에서는 부사장입니다. 이 사무소에는 다른 직무도 있을 수 있습니다. `governmentOfficer` - 선출된 임원진. 미국 주에서는 법무장관, 감사관, 장관, 주정부, 재무관과 같은 직무가 여기에 포함될 수 있습니다. `executiveCouncil` - 그룹으로서 임원 지부 역할을 수행하는 집행 위원회의 구성원입니다. 예를 들어 인디애나 카운티 감독관이 있습니다. `legislatorUpperBody` - 양원제 입법부의 상부 의원 또는 일원제도의 유일한 입법 기관입니다. `legislatorLowerBody` - 양원제 입법부의 하급 의원입니다. `highestCourtJudge` -- 주 대법원과 같은 특정 정부의 대법원입니다. `judge` -- 정부의 최고 법원이 아닌 법원의 판사입니다. `schoolBoard` - 지역 교육위원회의 구성원입니다. `specialPurposeOfficer`: 토양 및 수자원 보존 위원회의 구성원 또는 모기 저감 책임자와 같이 정해진 하나의 목적을 위해 수행하는 담당자입니다.
`offices[].sources[]`	`list`	이 사무실의 출처 목록입니다. 여러 소스가 표시되는 경우 해당 소스에서 집계된 데이터입니다.
`offices[].sources[].name`	`string`	데이터 소스의 이름입니다.
`offices[].sources[].official`	`boolean`	데이터의 공식 정부 출처인지 여부

선출직 공직자

속성 이름	값	설명
`officials[]`	`list`	위에 나열된 사무실을 둔 공무원. 요청에서 includeOffices가 true인 경우에만 존재합니다.
`officials[].address[]`	`list`	공무원에게 연락할 주소입니다.
`officials[].address[].city`	`string`	주소의 시/군/구입니다.
`officials[].address[].line1`	`string`	이 주소의 도로명과 번지입니다.
`officials[].address[].line2`	`string`	필요한 경우 두 번째 줄에는 주소를 입력합니다.
`officials[].address[].line3`	`string`	필요한 경우 주소의 세 번째 줄입니다.
`officials[].address[].locationName`	`string`	위치의 이름입니다.
`officials[].address[].state`	`string`	미국의 두 글자로 된 주 약어입니다.
`officials[].address[].zip`	`string`	주소의 미국 우편번호입니다.
`officials[].channels[]`	`list`	이 공무원의 알려진 (소셜) 미디어 채널 목록입니다.
`officials[].channels[].id`	`string`	후보 채널의 고유한 공개 식별자입니다.
`officials[].channels[].type`	`string`	채널 유형입니다. 다음은 채널 유형 목록이며 전체 목록은 아닙니다. 향후 더 많은 채널 유형을 추가할 수 있습니다. 다음 중 하나: YouTube, Facebook, Twitter
`officials[].emails[]`	`list`	공무원의 직속 이메일 주소입니다.
`officials[].name`	`string`	공무원의 이름입니다.
`officials[].party`	`string`	공무원이 속한 정당의 전체 이름입니다.
`officials[].phones[]`	`list`	공무원의 공개 연락처 전화번호
`officials[].photoUrl`	`string`	공무원의 사진 URL입니다.
`officials[].urls[]`	`list`	공무원의 공개 웹사이트 URL

방법

representativeInfoByAddress: 단일 주소에 대한 정치적 지역 및 대표 정보를 조회합니다.
representativeInfoByDivision: 단일 지역의 대표 정보를 조회합니다.