OfficeScope
實體是用來指定 ElectionEvent
和 OfficeholderSubFeed
實體對應的辦公室。
元素
名稱 | 標記 | 類型 | 附註 | 多重性 |
---|---|---|---|---|
偵錯名稱 | 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" ] } } }