このページは Cloud Translation API によって翻訳されました。

OfficeScope

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

要素

Name	タグ	タイプ	メモ	重複
デバッグ名	`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

例

次の例は、OfficeScope の ElectionEvent を含む Feed です。これは、Feed に、国レベルの大統領を選出するための 1 つ以上の選挙、1 つ以上の下院議席、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"
     ]
   }
 }
}