OfficeScope

OfficeScope 實體的用途是指定 ElectionEvent 和 「OfficeholderSubFeed」實體對應。

元素

名稱 標記 類型 附註 多重性
偵錯名稱 DebugName String 辦公室使用的描述性名稱。 0 或 1
辦公室層級 OfficeLevel OfficeLevel 指定這個範圍內的辦公室層級： Country 代表全國，Administrative Area 1 代表州或省等 1
管轄區 OCD ID JurisdictionOcdId Ocd Id 如果 OfficeLevel 為 Country，則為選用欄位。 非必填。這個欄位可指定政治地理位置。 舉例來說，如果州/省是維吉尼亞州對賓州或曼尼托巴省 對比安大略省 0 或 1
Office 角色 OfficeRoles OfficeRole 資料集內含的角色清單，尤其是 此辦公室層級的選舉 OCD ID 的當選人 依此類推 須為 1 以上
ElectoralDistrictCollection ElectoralDistrictCollection Ocd Id 所列選舉選區投票的 OCD ID 清單 職務如果清單空白，表示範圍包含所有可能項目 指定選舉地點或公職人員的行政區。 0 或 1

範例

以下範例是一個 Feed，其中包含的 ElectionEvent，其中包含 OfficeScope。這表示 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"
     ]
   }
 }
}