OfficeScope
항목은 ElectionEvent
및 OfficeholderSubFeed
항목이 해당하는 사무실을 지정하는 데 사용됩니다.
요소
이름 | 태그 | 유형 | Notes | 다중성 |
---|---|---|---|---|
디버그 이름 | DebugName |
String |
사무실을 설명하는 이름입니다. | 0 또는 1 |
사무실 수준 | OfficeLevel |
OfficeLevel |
전국의 경우 Country , 주/도의 경우 Administrative Area 1 등 이 범위 내의 사무실 수준을 지정합니다. |
1 |
관할권 OCD ID | JurisdictionOcdId |
Ocd Id |
OfficeLevel 가 Country 이면 선택사항이고 그 외의 경우에는 필수 항목입니다. 이 필드를 사용하여 정치적 지역을 지정합니다.
예를 들어 주가 버지니아와 펜실베이니아로 구분되거나 매니토바와 온타리오로 비교될 수 있습니다. |
0 또는 1 |
사무실 역할 | OfficeRoles |
OfficeRole |
데이터 세트에 포함된 역할 목록으로, 특히 이 직책, 관할권 OCD ID 등의 선출자로 제한됩니다. | 1개 이상 |
ElectoralDistrictCollection | ElectoralDistrictCollection |
Ocd Id |
나열된 공직자 역할에 투표하는 선거구의 OCD ID 목록 빈 목록은 지정된 선거 위치 또는 공직자의 가능한 모든 선거구가 범위에 포함되어 있음을 나타냅니다. | 0 또는 1 |
예
다음 예는 OfficeScope
가 있는 ElectionEvent
가 포함된 Feed
입니다. 이는 Feed
에 국가 수준의 대통령, 하나 이상의 하원 의석, 하나 이상의 하원 의원 선출을 위한 하나 이상의 선거에 대한 데이터를 포함 (또는 포함할 것으로 예상됨)을 나타냅니다.
XML
<OfficeScope> <DebugName>Scope of US general election</DebugName> <OfficeLevel>Country</OfficeLevel> <JurisdictionOcdId>ocd-division/country:us</JurisdictionOcdId> <OfficeRoles>president</OfficeRoles> <OfficeRoles>lower house</OfficeRoles> <OfficeRoles>upper house</OfficeRoles> </OfficeScope>
JSON
{ "OfficeScope": { "DebugName": "Scope of US general election", "OfficeLevel": "Country", "JurisdictionOcdId": "ocd-division/country:us", "OfficeRoles": [ "president", "lower house", "upper house" ] } }
동일한 ElectionEvent
에 버지니아주와 펜실베이니아주에서 여러 주 수준의 역할에 대한 여러 주 수준의 선거를 나타내는 추가 OfficeScope
항목이 포함될 수 있습니다.
XML
<OfficeScope> <DebugName>Virginia election scope</DebugName> <OfficeLevel>Administrative Area 1</OfficeLevel> <JurisdictionOcdId>ocd-division/country:us/state:va</JurisdictionOcdId> <OfficeRoles>attorney general</OfficeRoles> <OfficeRoles>state executive</OfficeRoles> </OfficeScope> <OfficeScope> <DebugName>Pennsylvania election scope</DebugName> <OfficeLevel>Administrative Area 1</OfficeLevel> <JurisdictionOcdId>ocd-division/country:us/state:pa</JurisdictionOcdId> <OfficeRoles>state lower house</OfficeRoles> <OfficeRoles>state upper house</OfficeRoles> <OfficeRoles>state executive</OfficeRoles> </OfficeScope>
JSON
{ "OfficeScope": { "DebugName": "Virginia election scope", "OfficeLevel": "Administrative Area 1", "JurisdictionOcdId": "ocd-division/country:us/state:va", "OfficeRoles": [ "attorney general", "state executive" ] } } { "OfficeScope": { "DebugName": "Pennsylvania election scope", "OfficeLevel": "Administrative Area 1", "JurisdictionOcdId": "ocd-division/country:us/state:pa", "OfficeRoles": [ "state lower house", "state upper house", "state executive" ] } }
필요한 경우 ElectionEvent
는 나열된 공직자 역할에 투표하는 선거구를 지정하는 OfficeScope
항목을 포함할 수 있습니다.
XML
<OfficeScope> <DebugName>US general election scope</DebugName> <OfficeLevel>National</OfficeLevel> <JurisdictionOcdId>ocd-division/country:us</JurisdictionOcdId> <OfficeRoles>upper house</OfficeRoles> <ElectoralDistrictCollection> <OcdId>ocd-division/country:us/state:ar</OcdId> <OcdId>ocd-division/country:us/state:ca</OcdId> <OcdId>ocd-division/country:us/state:ct</OcdId> <OcdId>ocd-division/country:us/state:de</OcdId> <OcdId>ocd-division/country:us/state:fl</OcdId> </ElectoralDistrictCollection> </OfficeScope>
JSON
{ "OfficeScope": { "DebugName" : "US general election scope", "OfficeLevel": "National", "JurisdictionOcdId": "ocd-division/country:us", "OfficeRoles": "upper house", "ElectoralDistrictCollection": { "OcdId" : [ "ocd-division/country:us/state:ar", "ocd-division/country:us/state:ca", "ocd-division/country:us/state:ct", "ocd-division/country:us/state:de", "ocd-division/country:us/state:fl" ] } } }