GpUnit и связанные элементы

Геополитическая единица, или GpUnit , описывает любую физическую или виртуальную единицу представительства или агрегирования голосов/мест. Используйте эту сущность для определения геополитических единиц, таких как города, округа, юрисдикции или избирательные участки, чтобы связать выборы, должности, подсчет голосов или другую информацию с этими географическими регионами.

GpUnit

Следующие сущности содержат ссылки на GpUnit :

  • Election , Contest и Office содержат обязательную ссылку на элемент GpUnit , который определяет юрисдикцию выборов, конкурса или должности соответственно.
  • SummaryCounts и VoteCounts ссылаются на GpUnit для связи сводных данных или количества голосов с элементами GpUnit , определенными для избирательных участков или других типов геополитических единиц.

Отношения «родитель-потомок» для аналогичных сущностей GpUnit должны быть согласованными. Например, все избирательные округа должны иметь одного родителя, которым является штат, даже если конкретный избирательный округ полностью находится в пределах графства.

Атрибуты

В следующей таблице описаны атрибуты GpUnit :

Атрибут Необходимый? Тип Описание
objectId Необходимый ID Уникальный внутренний идентификатор, используемый другими элементами для ссылки на этот элемент.

Элементы

В следующей таблице описаны элементы GpUnit :

Элемент Множественность Тип Описание
ComposingGpUnitIds 0 или 1 IDREFS

Уникальный идентификатор для одного или нескольких элементов GpUnit . Используется для ссылки на другие элементы GpUnit и связывания их с родительским GpUnit . Каждый ссылочный элемент должен быть определен для геополитической единицы, которая содержится в родительском элементе GpUnit .

Используйте элемент ComposingGpUnitIds , чтобы отображать только непосредственных потомков конкретного GpUnit . Например, если избирательные участки A и B находятся в городе M, а город M находится в округе X, то укажите избирательные участки A и B как потомков города M. Тогда город M будет потомком округа X, но не делайте избирательные участки A и B потомками округа X.

ExternalIdentifiers 0 или 1 ExternalIdentifiers

Привязывает идентификатор к GpUnit , например, код района или города.

При использовании ExternalIdentifiers , если тип не указан в перечислении IdentifierType , используйте Type other и укажите свой пользовательский тип в OtherType .

Name 0 или 1 string Название геополитической единицы.
SummaryCounts 0 или более SummaryCounts

Сводные данные по бюллетеням, такие как количество голосов с превышением числа голосов, с недостатком голосов и общее количество бюллетеней. При желании их можно разбить по типу устройства и категории бюллетеня.

GpUnit включает SummaryCounts , предоставляющий сводные данные по соответствующему геополитическому региону.

Подразделение отчетности

Используйте ReportingUnit для определения геополитической единицы, такой как штат, город, поселок или избирательный участок, с помощью перечисления ReportingUnitType .

Элемент Election используется для определения географического охвата выборов. В данном случае элемент ReportingUnit , определяющий охват выборов, может включать ElectionAdministration для предоставления информации, связанной с избирательным органом.

ReportingUnit может быть дочерним элементом максимум одного другого ReportingUnit . Однако, если подразделению ReportingUnit требуется несколько родительских элементов, поскольку оно по праву охватывает несколько родительских элементов ReportingUnit , обратитесь за консультацией к своему контактному лицу в Google.

XML-синтаксис для ReportingUnit выглядит следующим образом: <GpUnit xsi:type="ReportingUnit" ... /> .

Элементы

В следующей таблице описаны элементы для ReportingUnit ):

Элемент Множественность Тип Описание
AuthorityIds 0 или 1 IDREFS objectId одного или нескольких элементов Person , описывающих орган, ответственный за подразделение, подлежащее отчетности.
ContactInformation 0 или 1 ContactInformation Контактная информация сотрудников, имеющих дело с подразделением, предоставляющим отчеты, например, адрес избирательного участка.
CountStatus 0 или более CountStatus Предоставляет информацию о различных статусах подсчета для разных типов бюллетеней или других документов.
ElectionAdministration 0 или 1 ElectionAdministration Предоставляет информацию об избирательном органе. Используйте эту информацию, когда отчитывающееся подразделение выступает в качестве органа, ответственного за проведение выборов.
InternationalizedName 1 InternationalizedText Локализованное, полное, каноническое название геополитической единицы, а не аббревиатура. Например, «Аляска» или «14-й избирательный округ Нью-Йорка».
IsDistricted 0 или 1 boolean Логическое значение IsDistricted можно использовать несколькими способами. Оно не является строго необходимым, поскольку можно идентифицировать округа по их подэлементу Type . Вы также можете изучить подэлемент ElectoralDistrictId элемента Contest , который ссылается на избирательный округ, связанный с конкурсом. Однако, если округ определен, но не связан с конкурсом, или если тип округа указан с помощью OtherType , то IsDistricted необходим для идентификации GpUnit как округа. Логическое значение IsDistricted также может использоваться для обозначения того, что GpUnit , определенный как юрисдикция, например, город, также используется как округ, например, для общегородских конкурсов.
IsMailOnly 0 или 1 boolean Указывает, обрабатывает ли отчетное подразделение только выборы, проводимые по почте, или выборы с использованием заочных бюллетеней. Если этот параметр отсутствует, значение по умолчанию — false .
SubUnitsReported 0 или 1 integer Количество связанных подразделений, таких как избирательные участки, которые завершили предоставление отчетов.
TotalSubUnits 0 или 1 integer Общее количество связанных подразделений, таких как избирательные участки.
Type 1 ReportingUnitType

Указан тип отчитывающейся единицы, например, штат, город, район или избирательный участок.

Если тип отчетной единицы не указан в перечислении ReportingUnitType , используйте Type other и укажите свой пользовательский тип отчетной единицы в OtherType .

OtherType 0 или 1 string Используется для указания типа геополитической единицы, если значение параметра ReportingUnitType равно other .
VotersParticipated 0 или 1 integer Количество избирателей, принявших участие в выборах. То есть, сколько человек явилось на избирательные участки, включая тех, кто не голосовал.
VotersRegistered 0 или 1 integer Число зарегистрированных избирателей, проживающих в пределах границ геополитической единицы.

Примеры

XML 

    <GpUnit objectId="ru0081" xsi:type="ReportingUnit">
      <ComposingGpUnitIds>ru_wahlkreis1 ru_wahlkreis2</ComposingGpUnitIds>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-state-0081</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>ocd-id</Type>
          <Value>ocd-division/country:de/state:hb</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <InternationalizedName>
        <Text language="en">Bremen</Text>
      </InternationalizedName>
      <Name>Bremen</Name>
      <Type>state</Type>
    </GpUnit>

JSON 

    "GpUnit": [
      {
        "@type": "ReportingUnit",
        "objectId": "ru0081",
        "ComposingGpUnitIds": [
          "ru_wahlkreis1",
          "ru_wahlkreis2"
        ],
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-state-0081"
            },
            {
              "Type": "ocd-id",
              "Value": "ocd-division/country:de/state:hb"
            }
          ]
        },
        "InternationalizedName": {
          "Text": [
            {
              "language": "en",
              "value": "Bremen"
            }
          ]
        },
        "Name": "Bremen",
        "Type": "state"
      }
    ]