OfficeScope

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

示例

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