Используйте 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 . |
FilingDeadline | 0 или 1 | PartialDate | Крайний срок, до которого кандидат должен подать заявку на участие в конкурсе. |
HasRotation | 0 или 1 | boolean | Указывает, осуществляется ли ротация вариантов выбора в конкурсе. Если этот элемент отсутствует, значение по умолчанию — false . |
Name | 1 | string | Это должно соответствовать BallotTitle на английском языке и синтаксису заголовка . |
Seat | 0 или 1 | string | Конкретное место, за которое проводится конкурс. |
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 . Связывает описание 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 :
| Элемент | Множественность | Тип | Описание |
|---|---|---|---|
NumberElected | 0 или 1 | integer | Количество кандидатов, избранных в ходе конкурса, равное n в конкурсе n-of-m . Если NumberElected отсутствует в ленте, используется значение по умолчанию 1 . |
VotesAllowed | 0 или 1 | integer | Максимальное количество голосов или вариантов, разрешенных для голосования одним избирателем в этом конкурсе. Если VotesAllowed отсутствует в ленте, используется значение по умолчанию, равное 1 . |
OfficeIds | 1 | IDREFS | Уникальный идентификатор для одного или нескольких элементов Office . Связывает описание 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 :
| Элемент | Множественность | Тип | Описание |
|---|---|---|---|
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 | IDREF | Идентификационный номер кандидата, представляющего интересы должностного лица, занимающего данную должность в настоящее время. |
OfficeID | 0 или 1 | IDREF | Идентификационный номер должности, которую в настоящее время занимает должностное лицо. |
Примеры
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>