Используйте Contest
для описания конкурса и связи конкурса с соответствующими кандидатами и партиями.
В этом документе обсуждается Contest
и его подсистемы:
-
Contest
-
CandidateContest
-
PartyContest
-
BallotMeasureContest
-
RetentionContest
-
Типы
Contest
— это абстрактный элемент с тремя типами, которые используются в зависимости от типа конкурса:
-
CandidateContest
: используйте этот тип, когда вContest
участвуют один или несколько кандидатов на должность. -
PartyContest
: используйте этот тип, когда в бюллетене для голосования поContest
есть выбор партийного списка. -
BallotMeasureContest
: используйте этот тип, когдаContest
включает в себя одну или несколько мер голосования. -
RetentionContest
: используйте этот тип, когдаContest
предполагает референдум для решения вопроса о том, должно ли избранное должностное лицо оставаться на своей должности или быть отстранено от нее.
По мере публикации результатов выборов вы можете обновлять свой фид, чтобы отображать различные этапы результатов, такие как экзитполы или оценки. Google предоставляет информацию о том, какие этапы выборов и типы результатов мы ожидаем. Google может запросить один или несколько этапов. Эти значения могут измениться в ночь выборов. Установите начальное значение фида, соответствующее этапу, с которого нужно начать. Подробнее см. в разделе ExternalIdentifiers
в разделе «Элементы» .
Атрибуты
В следующей таблице описаны атрибуты для Contest
:
Атрибут | Необходимый? | Тип | Описание |
---|---|---|---|
objectId | Необходимый | ID | Уникальный внутренний идентификатор, который используется другими элементами для ссылки на этот элемент. |
Элементы
В следующей таблице описываются элементы Contest
:
Элемент | Множественность | Тип | Описание |
---|---|---|---|
Abbreviation | 0 или 1 | string | Краткое название конкурса. |
BallotSelection | 0 или больше | BallotSelection | Связывает выбранные кандидатуры в бюллетене с конкурсом. Порядок кандидатов или партий в Если для каждого элемента присутствует |
BallotSubTitle | 0 или 1 | InternationalizedText | Подзаголовок конкурса должен соответствовать названию, указанному в бюллетенях для голосования. |
BallotTitle | 0 или 1 | InternationalizedText | Название конкурса. Текст заголовка должен соответствовать руководству по синтаксису . Для конкурсов по мерам, предлагаемым к участию в голосовании, название должно соответствовать формулировке в бюллетене. |
ComposingContestIds | 0 или больше | IDREFS | Используется для определения конкурса на объединение голосов. Например, на всеобщих президентских выборах в США проводится конкурс национального уровня с составлением идентификаторов для каждого из выборов на уровне штата. |
ContestDateStatus | 0 или 1 | DateStatus | Этот элемент указывает на обновление расписания выборов. Значение по умолчанию — |
ElectoralDistrictId | 1 | IDREF | Уникальный идентификатор элемента Например, для конкретного конкурса |
ExternalIdentifiers | 1 | ExternalIdentifiers | Связывает идентификатор с конкурсом. Требуется стабильный идентификатор . Чтобы указать этап результатов выборов, указанный в вашей ленте, задайте для OtherType значение из ContestStage . |
HasRotation | 0 или 1 | boolean | Указывает, чередуются ли выбранные в конкурсе варианты. Если этот элемент отсутствует, значение по умолчанию — false . |
Name | 1 | string | Он должен соответствовать BallotTitle на английском языке и соответствовать синтаксису заголовка . |
SequenceOrder | 0 или 1 | integer | Порядок элементов
|
SubsequentContestId | 0 или 1 | IDREF | Используется для указания на более поздний этап выборов в том же связанном наборе. Например, на выборах в США этот указатель обычно указывает с праймериз на соответствующие всеобщие выборы. Он также может указывать с всеобщих выборов на второй тур. |
SubUnitsReported | 0 или 1 | integer | Количество подразделений, например, избирательных округов, завершивших регистрацию голосов по данному конкурсу. |
SummaryCounts | 0 или больше | SummaryCounts | Предоставляет сводку различных показателей, связанных с конкурсом. Включает общее количество поданных бюллетеней, содержащих информацию о конкурсе, а также общее количество воздержавшихся, голосов с перевесом, голосов без перевеса или голосов без перевеса, а также вписанных голосов. Сводные показатели могут быть связаны с конкурсом в целом или с другими отчётными единицами более низкого уровня с помощью многократного использования SummaryCounts . |
TotalSubUnits | 0 или 1 | integer | Общее количество подразделений, например, избирательных округов, в бюллетенях которых этот конкурс вынесен на голосование. |
VoteVariation | 0 или 1 | VoteVariation | Тип вариации голосования, связанный с конкурсом, например n-of-m . |
OtherVoteVariation | 0 или 1 | string | Используется для предоставления пользовательского значения, когда VoteVariation имеет значение other . |
StartDate | 0 или 1 | PartialDate | Календарная дата начала конкурса. Используйте дату начала голосования, например, 08.11.2022. Дату начала следует указывать только в том случае, если даты начала и окончания Contest отличаются от дат начала и окончания Election . |
EndDate | 0 или 1 | PartialDate | Календарная дата окончания конкурса. Используйте дату окончания голосования, например, 08.11.2022. Дату окончания следует указывать только в том случае, если даты начала и окончания Contest отличаются от дат начала и окончания Election . |
CountingDate | 0 или 1 | PartialDate | Дата подсчёта голосов после голосования на выборах. Этот день следует указывать только в том случае, если день подсчёта голосов отличается от последнего дня голосования, например, на выборах в Лок Сабху (Индия). Обычно подсчёт голосов происходит в тот же день, что и последний день голосования, то есть в EndDate выборов. |
КандидатКонкурс
Используйте CandidateContest
для описания конкурса, включающего выбор одного или нескольких кандидатов.
Эта сущность может опционально ссылаться на Office
или Party
по идентификатору. Мы не поддерживаем представление заявок кандидатов в одном и том же конкурсе; можно ссылаться только на одну Office
. Так, например, для заявок президента и вице-президента вам потребуется два конкурса Candidate
. Каждый из них будет ссылаться на отдельную должность.
Элементы
В следующей таблице описаны элементы CandidateContest
:
Элемент | Множественность | Тип | Описание |
---|---|---|---|
NumberElected | 0 или 1 | integer | Количество кандидатов, избранных в ходе голосования, то есть n-е число в голосовании n-of-m . Если NumberElected отсутствует в ленте, используется значение по умолчанию — 1 . |
OfficeIds | 1 | IDREFS | Уникальный идентификатор одного или нескольких элементов Office . Связывает описание офиса с конкурсом. |
PrimaryPartyIds | 0 или больше | IDREFS | Уникальный идентификатор одного или нескольких элементов Party , указывающий на то, что Contest является частью партийных праймериз. PrimaryPartyId имеет смысл только на праймериз. |
VotesAllowed | 1 | integer | Максимальное количество голосов или ответов, разрешенных для одного избирателя в этом конкурсе. Если в ленте нет VotesAllowed , используется значение по умолчанию — 1 . |
Type | 0 или больше | ElectionType | Указанный тип конкурса, например, первичный или общий. Тип Contest следует указывать только в том случае, если он отличается от типа Election . |
Примеры
XML
<Contest xsi:type="CandidateContest" objectId="cc1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-muite">...</BallotSelection> <BallotTitle> <Text language="en">2022 Kenya Presidential election</Text> <Text language="es">2022 Elecciones presidenciales de Kenia</Text> <Text language="fr">2022 Élection présidentielle au Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>2022 Kenya Presidential election</Name> <StartDate>2022-08-09</StartDate> <SubUnitsReported>48</SubUnitsReported> <SummaryCounts>...</SummaryCounts> <TotalSubUnits>48</TotalSubUnits> <VoteVariation>1-of-m</VoteVariation> <NumberElected>1</NumberElected> <OfficeIds>off9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
JSON
"Contest": [ { "@type": "CandidateContest", "objectId": "cc1-001", "Abbreviation": "KENYAPRES", "BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs1-001-kenyatta", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-odinga", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-mudavadi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kenneth", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-dida", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-karua", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kiyiapi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-muite", ... } ], "BallotTitle": { "Text": [ { "value": "2022 Kenya Presidential election", "language": "en" }, { "value": "2022 Elecciones presidenciales de Kenia", "language": "es" }, { "value": "2022 Élection présidentielle au Kenya", "language": "fr" }, ] }, "CountStatus": "...", "ElectoralDistrictId": "...", "Name": "2022 Kenya Presidential election", "SubUnitsReported": 48, "SummaryCounts": "...", "TotalSubUnits": 48, "VoteVariation": "1-of-m", "NumberElected": 1, "VotesAllowed": 1, "Type": "general" } ]
PartyContest
Используйте PartyContest
для конкурса, в котором избиратели выбирают партию в бюллетене.
Элементы
В следующей таблице описаны элементы PartyContest
:
Элемент | Множественность | Тип | Описание |
---|---|---|---|
NumberElected | 0 или 1 | integer | Количество кандидатов, избранных в ходе голосования, то есть n-е число в голосовании n-of-m . Если NumberElected отсутствует в ленте, используется значение по умолчанию — 1 . |
VotesAllowed | 0 или 1 | integer | Максимальное количество голосов или ответов, разрешенных для одного избирателя в этом конкурсе. Если в ленте нет VotesAllowed , используется значение по умолчанию — 1 . |
OfficeIds | 1 | IDREFS | Уникальный идентификатор одного или нескольких элементов Office . Связывает описание офиса с конкурсом. |
Type | 0 или больше | ElectionType | Указанный тип конкурса, например, первичный или общий. Тип Contest следует указывать только в том случае, если он отличается от типа Election . |
Примеры
XML
<Contest xsi:type="PartyContest" objectId="pc20001"> <BallotSelection objectId="ps101321" xsi:type="PartySelection"> <PartyIds>par10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps101322" xsi:type="PartySelection"> <PartyIds>par10133</PartyIds> </BallotSelection> <BallotTitle> <Text language="en">Ballot title example</Text> </BallotTitle> <ContestDateStatus>confirmed</ContestDateStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <ExternalIdentifiers>...</ExternalIdentifiers> <Name>Contest name example</Name> <StartDate>2022-08-09</StartDate> <VoteVariation>1-of-m</VoteVariation> <OfficeIds>off9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
JSON
"Contest": [ { "@type": "PartyContest", "objectId": "pc20001", "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps101321", "PartyIds": [ "par10132" ] } ], "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps101322", "PartyIds": [ "par10133" ] } ], "BallotTitle": { "Text": [ { "value": "Ballot title example", "language": "en" } ] }, "ContestDateStatus": "confirmed", "CountingDate": "2022-08-11", "ElectoralDistrictId": "...", "EndDate": "2022-08-09", "ExternalIdentifiers": [ ... ], "Name": "Contest name example", "StartDate": "2022-08-09", "VoteVariation": "1-of-m", "OfficeIds": "off9999a", "Type": "general", "VotesAllowed": 1 } ]
BallotMeasureContest
Используйте BallotMeasureContest
для конкурса, в котором участвуют меры, принимаемые путем голосования.
Элементы
В следующей таблице описаны элементы BallotMeasureContest
:
Элемент | Множественность | Тип | Описание |
---|---|---|---|
BallotTitle | 1 | InternationalizedText | Официальное название бюллетеня, например Некоторые референдумы имеют единое общее название с несколькими пронумерованными вопросами. В таких случаях название может включать номер вопроса, чтобы различать сущности |
BallotSubTitle | 0 или 1 | InternationalizedText | Подзаголовок бюллетеня, если таковой имеется. |
BallotText | 1 | InternationalizedText | Текст, который указан в самом бюллетене. Например: Shall Article 4 of the Nevada Constitution be amended to require, beginning in calendar year 2022, that all providers of electric utility services who sell electricity... in Nevada comes from renewable energy resources? |
FullText | 0 или 1 | InternationalizedText | Копия полного текста законопроекта, выносимого на голосование. Укажите этот элемент, если в бюллетене отсутствует дополнительный текст. Ограничение: 30 000 символов. Если полный текст бюллетеня короче 30 000 символов и не содержит форматирования, которое было бы недопустимо в файле-канале, включите его в |
InfoUri | 0 или 1 | AnnotatedUri | Аннотированный URI, который принимает следующие аннотации, а не аннотации, перечисленные в другом месте:
|
SummaryText | 0 или 1 | InternationalizedText | Краткое изложение бюллетеня. Состоит из одного-двух коротких абзацев и может быть составлено партнёром для краткого изложения полного текста бюллетеня, как в следующем примере: |
ProStatement | 0 или 1 | InternationalizedText | Заявление, объясняющее, что означает голосование «за» по данной мере. Это не аргумент в пользу этой меры. Например: A "yes" vote supports this initiative to require electric utilities to acquire 50 percent of their electricity from renewable resources by 2030. |
ConStatement | 0 или 1 | InternationalizedText | Заявление, объясняющее, что означает отрицательный ответ на данную инициативу. Это не аргумент против неё. Например: A "no" vote opposes this initiative, thus keeping the existing requirement that electric utilities acquire 25 percent of their electricity from renewable resources by 2025. |
Type | 0 или 1 | BallotMeasureType | Перечисленный тип избирательной меры. Выберите значение, которое наилучшим образом описывает избирательную меру в соответствующей юрисдикции. |
PassageThreshold | 0 или 1 | string | Минимальная доля голосов, необходимая для принятия предложения. |
Примеры
XML
<Contest objectId="bmc0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_no</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotSubTitle> <Text language="en">Farm Animal Confinement Initiative</Text> </BallotSubTitle> <BallotTitle> <Text language="en"> California Proposition 12, Farm Animal Confinement Initiative (2018) </Text> </BallotTitle> <ElectoralDistrictId>ru_ca_1</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name> California Proposition 12, Farm Animal Confinement Initiative (2018) </Name> <BallotText> <Text language="en"> Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure. </Text> </BallotText> <ConStatement> <Text language="en">No means the measure will not be enacted </Text> </ConStatement> <InfoUri Annotation="fulltext"> https://example-government.gov/ballot-measures/California_Proposition_12_2018 </InfoUri> <InfoUri Annotation="wikipedia"> https://en.wikipedia.org/wiki/2018_California_Proposition_12 </InfoUri> <PassageThreshold> <Text language="en">50.01%</Text> </PassageThreshold> <ProStatement> <Text language="en">Yes means the measure will be enacted </Text> </ProStatement> <SummaryText> <Text language="en"> The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements. </Text> </SummaryText> <Type>ballot-measure</Type> </Contest>
JSON
"Contest": [ { "@type": "BallotMeasureContest", "objectId": "bmc0", "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms00", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_yes" } ] } } "Text": [ { "value": "Yes", "language": "en" }, ] ], "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms01", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_no" } ] } } "Text": [ { "value": "No", "language": "en" }, ] ], "BallotSubTitle": { "Text": [ { "value": "Farm Animal Confinement Initiative", "language": "en" } ] }, "BallotTitle": { "Text": [ { "value": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "language": "en" } ] }, "ElectoralDistrictId": "ru_ca_1" "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0" } ] }, "Name": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "BallotText": [ "Text": [ { "value": "Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure.", "language": "en" } ] ], "ConStatement": [ "Text": [ { "value": "No means the measure will not be enacted", "language": "en" } ] ], "InfoUri": [ { "value": "https://example-government.gov/ballot-measures/California_Proposition_12_2018", "annotation": "fulltext" } ], "InfoUri": [ { "value": "https://en.wikipedia.org/wiki/2018_California_Proposition_12", "annotation": "wikipedia" } ], "PassageThreshold": [ "Text": [ { "value": "50.01%", "language": "en" } ] ], "ProStatement": [ "Text": [ { "value": "Yes means the measure will be enacted", "language": "en" } ] ], "SummaryText": [ "Text": [ { "value": "The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements.", "language": "en" } ] ], "Type": "ballot-measure", } ]
Конкурс удержания
Используйте этот тип, когда Contest
предполагает референдум для решения вопроса о том, должно ли избранное должностное лицо оставаться на своем посту или быть отстранено от него.
Это включает в себя такие случаи, как конкурсы на удержание судей в некоторых штатах США, в ходе которых решается, следует ли судье оставаться на новый срок. Это также относится к выборам по отзыву, в ходе которых решается, следует ли отстранить должностное лицо от должности до окончания срока его полномочий.
Элементы
Все элементы BallotMeasureContest
также применимы к RetentionContest
.
Элемент | Множественность | Тип | Описание |
---|---|---|---|
CandidateID | 1 | ИДРЕФ | Удостоверение личности кандидата, представляющего должностное лицо, которое в настоящее время занимает эту должность |
OfficeID | 0 или 1 | ИДРЕФ | Идентификатор должности, которую в настоящее время занимает должностное лицо |
Примеры
XML
<Contest objectId="rc40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms' objectId prefix.--> <BallotSelection objectId="bms40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001at</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>vageneral-cont-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can12345</CandidateId> <OfficeId>off20006</OfficeId> </Contest>