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

Representatives

이 컬렉션은 정치적 지리와 선출직 공무원에 대한 정보를 담고 있습니다.

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

리소스 표현

이 컬렉션의 리소스에는 아래에 자세히 설명된 3개의 섹션이 있습니다. 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` - 국가의 두 번째 수준 행정 구역 단위 정부(예: 미국 카운티) `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: 단일 지리적 구역의 대표 정보를 조회합니다.