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 юрисдикции и т. д. 1 или более
ElectoralDistrictCollection 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"
     ]
   }
 }
}