OfficeScope

OfficeScope エンティティは、ElectionEvent エンティティと OfficeholderSubFeed エンティティがどのオフィスに対応するかを指定するために使用されます。

要素

名前 タグ タイプ メモ 重複
デバッグ名 DebugName string オフィスのわかりやすい名前。 0 または 1
Office レベル 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

例

次の例は、OfficeScope を含む ElectionEvent を含む Feed です。これは、Feed に、国レベルの大統領、下院の議席、上院の議席を 1 つ以上選出する選挙に関するデータが含まれている（または含まれる予定である）ことを示します。

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"
     ]
   }
 }
}