OfficeScope

Сущности OfficeScope используются для указания того, каким офисам соответствуют сущности ElectionEvent и OfficeholderSubFeed .

Элементы

Имя Ярлык Тип Примечания Множественность
Имя отладки DebugName String Описательное имя, используемое для офиса. 0 или 1
Уровень офиса OfficeLevel OfficeLevel Указывает уровень офисов в этой области: Country для национального уровня, Administrative Area 1 для штата или провинции и т. д. 1
Идентификатор OCD юрисдикции JurisdictionOcdId Ocd Id Необязательно, если OfficeLevel имеет Country , в противном случае требуется. Используйте это поле, чтобы указать политическую географию. Например, если штат — Вирджиния против Пенсильвании или Манитоба против Онтарио. 0 или 1
Офисные роли OfficeRoles OfficeRole Список ролей, содержащихся в наборе данных, конкретно ограниченный теми, кто избирается на этот уровень должности, идентификатором OCD юрисдикции и т. д. 1 или более
Избирательный РайонСбор ElectoralDistrictCollection Ocd Id Список идентификаторов OCD избирательных округов, голосующих за указанную должность. Пустой список означает, что область действия включает все возможные округа для указанного избирательного участка или должностного лица. 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"
     ]
   }
 }
}