Ищет информацию, имеющую отношение к избирателю, на основе зарегистрированного адреса избирателя. Попробуйте сейчас .
- Избирательные участки (в том числе участки для досрочного голосования) по данному адресу проживания
- Информация о конкурсе и кандидатах
- Официальная информация о выборах
Запрос
HTTP-запрос
GET https://www.googleapis.com/civicinfo/v2/voterinfo
Параметры
Имя параметра | Ценить | Описание |
---|---|---|
Обязательные параметры запроса | ||
address | string | Зарегистрированный адрес избирателя, который нужно найти. |
Необязательные параметры запроса | ||
electionId | long | Уникальный идентификатор выборов для поиска. Список идентификаторов выборов можно получить по адресу https://www.googleapis.com/civicinfo/{version}/elections. Если в запросе не указан идентификатор выборов и существует более одного выбора с данными для данного избирателя, дополнительные выборы предоставляются в поле ответа Если по указанному адресу избирателя не проводятся текущие выборы, ответ возвращает данные только в том случае, если указан идентификатор выборов. В этом случае мы рекомендуем, чтобы любой инструмент выдавал второй запрос с указанным идентификатором выборов, чтобы гарантировать, что пользователю предоставлены правильные данные о месте голосования, конкурсе и официальной информации о выборах (если применимо). |
officialOnly | boolean | Если установлено значение true, будут возвращены только данные из официальных государственных источников. (По умолчанию: false ) |
Тело запроса
Не предоставляйте тело запроса с помощью этого метода.
Ответ
В случае успеха этот метод возвращает тело ответа следующей структуры:
{ "kind": "civicinfo#voterInfoResponse", "election": elections Resource, "otherElections": [ elections Resource ], "normalizedInput": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "pollingLocations": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "earlyVoteSites": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "dropOffLocations": [ { "address": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "notes": string, "pollingHours": string, "name": string, "voterServices": string, "startDate": string, "endDate": string, "latitude": double, "longitude": double, "sources": [ { "name": string, "official": boolean } ] } ], "contests": [ { "type": string, "primaryParty": string, "electorateSpecifications": string, "special": string, "ballotTitle": string, "office": string, "level": [ string ], "roles": [ string ], "district": { "name": string, "scope": string, "id": string }, "numberElected": long, "numberVotingFor": long, "ballotPlacement": long, "candidates": [ { "name": string, "party": string, "candidateUrl": string, "phone": string, "photoUrl": string, "email": string, "orderOnBallot": long, "channels": [ { "type": string, "id": string } ] } ], "referendumTitle": string, "referendumSubtitle": string, "referendumUrl": string, "referendumBrief": string, "referendumText": string, "referendumProStatement": string, "referendumConStatement": string, "referendumPassageThreshold": string, "referendumEffectOfAbstain": string, "referendumBallotResponses": [ string ], "sources": [ { "name": string, "official": boolean } ] } ], "state": [ { "name": string, "electionAdministrationBody": { "name": string, "electionInfoUrl": string, "electionRegistrationUrl": string, "electionRegistrationConfirmationUrl": string, "electionNoticeText": string, "electionNoticeUrl": string, "absenteeVotingInfoUrl": string, "votingLocationFinderUrl": string, "ballotInfoUrl": string, "electionRulesUrl": string, "voter_services": [ string ], "hoursOfOperation": string, "correspondenceAddress": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "physicalAddress": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string }, "electionOfficials": [ { "name": string, "title": string, "officePhoneNumber": string, "faxNumber": string, "emailAddress": string } ] }, "local_jurisdiction": (AdministrationRegion), "sources": [ { "name": string, "official": boolean } ] } ], "mailOnly": boolean }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
kind | string | Определяет, что это за ресурс. Значение: фиксированная строка "civicinfo#voterInfoResponse" . | |
election | nested object | Выборы, которые были подвергнуты сомнению. | |
otherElections[] | list | Если для адреса избирателя проводится несколько выборов, otherElections заполняется в ответе API, и есть две возможности:1. Если эти выборы происходят в разные дни, API возвращает информацию о голосовании первых/самых ранних выборов. Если самые ранние выборы не являются запланированными, укажите идентификатор желаемых выборов во втором запросе API, используя поле electionId .2. Если эти выборы происходят в один и тот же день, API не возвращает какую-либо информацию об избирательном участке, конкурсе или официальной информации о выборах, чтобы гарантировать выполнение дополнительного запроса. Для приложений, ориентированных на пользователя, мы рекомендуем отображать эти выборы пользователю, чтобы устранить неоднозначность. Второй запрос API с использованием поля electionId должен быть сделан для выборов, которые имеют отношение к пользователю. | |
normalizedInput | nested object | Нормализованная версия запрошенного адреса | |
normalizedInput. locationName | string | Название локации. | |
normalizedInput. line1 | string | Название улицы и номер этого адреса. | |
normalizedInput. line2 | string | Вторая строка адрес, если необходимо. | |
normalizedInput. line3 | string | Третья строка адреса, если необходимо. | |
normalizedInput. city | string | Город или поселок для адреса. | |
normalizedInput. state | string | Двухбуквенное сокращение адреса в США. | |
normalizedInput. zip | string | Почтовый индекс адреса США. | |
mailOnly | boolean | Указывает, голосуют ли избиратели на участке только путем отправки бюллетеней по почте (с возможностью также опустить бюллетени). |
Пункты для голосования, места для досрочного голосования и места для высадки
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
pollingLocations[] | list | Места, где избиратель имеет право проголосовать в день выборов. | |
pollingLocations[]. address | nested object | Адрес места. | |
pollingLocations[].address. locationName | string | Название локации. | |
pollingLocations[].address. line1 | string | Название улицы и номер этого адреса. | |
pollingLocations[].address. line2 | string | Вторая строка адрес, если нужно. | |
pollingLocations[].address. line3 | string | Третья строка адреса, если необходимо. | |
pollingLocations[].address. city | string | Город или поселок для адреса. | |
pollingLocations[].address. state | string | Двухбуквенное сокращение адреса в США. | |
pollingLocations[].address. zip | string | Почтовый индекс адреса США. | |
pollingLocations[]. notes | string | Примечания об этом месте (например, пандус или вход в помещение). | |
pollingLocations[]. pollingHours | string | Описание того, когда это место открыто. | |
pollingLocations[]. name | string | Название места досрочного голосования или места высадки. Это поле не заполняется для избирательных участков. | |
pollingLocations[]. voterServices | string | Услуги, предоставляемые этим сайтом досрочного голосования или местом высадки. Это поле не заполняется для избирательных участков. | |
pollingLocations[]. startDate | string | Первая дата, когда можно будет использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
pollingLocations[]. endDate | string | Последняя дата, когда можно использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
pollingLocations[]. latitude | string | Широта места в градусах к северу от экватора. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
pollingLocations[]. longitude | string | Долгота местоположения в градусах к востоку от нулевого меридиана. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
pollingLocations[]. sources[] | list | Список источников для этого места. Если указано несколько источников, данные были агрегированы из этих источников. | |
pollingLocations[].sources[]. name | string | Имя источника данных. | |
pollingLocations[].sources[]. official | boolean | Поступают ли эти данные из официального правительственного источника. | |
earlyVoteSites[] | list | Места, где избиратель имеет право проголосовать досрочно, до дня выборов. | |
earlyVoteSites[]. address | nested object | Адрес места. | |
earlyVoteSites[].address. locationName | string | Название локации. | |
earlyVoteSites[].address. line1 | string | Название улицы и номер этого адреса. | |
earlyVoteSites[].address. line2 | string | Вторая строка адрес, если нужно. | |
earlyVoteSites[].address. line3 | string | Третья строка адреса, если необходимо. | |
earlyVoteSites[].address. city | string | Город или поселок для адреса. | |
earlyVoteSites[].address. state | string | Двухбуквенное сокращение адреса в США. | |
earlyVoteSites[].address. zip | string | Почтовый индекс адреса США. | |
earlyVoteSites[]. notes | string | Примечания об этом месте (например, пандус или вход в помещение). | |
earlyVoteSites[]. pollingHours | string | Описание того, когда это место открыто. | |
earlyVoteSites[]. name | string | Название места досрочного голосования или места высадки. Это поле не заполняется для избирательных участков. | |
earlyVoteSites[]. voterServices | string | Услуги, предоставляемые этим сайтом досрочного голосования или местом высадки. Это поле не заполняется для избирательных участков. | |
earlyVoteSites[]. startDate | string | Первая дата, когда можно будет использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
earlyVoteSites[]. endDate | string | Последняя дата, когда можно использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
earlyVoteSites[]. latitude | string | Широта места в градусах к северу от экватора. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
earlyVoteSites[]. longitude | string | Долгота местоположения в градусах к востоку от нулевого меридиана. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
earlyVoteSites[]. sources[] | list | Список источников для этого места. Если указано несколько источников, данные были агрегированы из этих источников. | |
earlyVoteSites[].sources[]. name | string | Имя источника данных. | |
earlyVoteSites[].sources[]. official | boolean | Поступают ли эти данные из официального правительственного источника. | |
dropOffLocations[] | list | Места, где избиратель имеет право сдать заполненный бюллетень. Избиратель должен получить и заполнить бюллетень до прибытия на место. В помещении может не быть бюллетеней для голосования. Эти места могут быть открыты в день выборов или до него, как указано в поле «Часы голосования». | |
dropOffLocations[]. address | nested object | Адрес места. | |
dropOffLocations[].address. locationName | string | Название локации. | |
dropOffLocations[].address. line1 | string | Название улицы и номер этого адреса. | |
dropOffLocations[].address. line2 | string | Вторая строка адрес, если необходимо. | |
dropOffLocations[].address. line3 | string | Третья строка адреса, если необходимо. | |
dropOffLocations[].address. city | string | Город или поселок для адреса. | |
dropOffLocations[].address. state | string | Двухбуквенное сокращение адреса в США. | |
dropOffLocations[].address. zip | string | Почтовый индекс адреса США. | |
dropOffLocations[]. notes | string | Примечания об этом месте (например, пандус или вход в помещение). | |
dropOffLocations[]. pollingHours | string | Описание того, когда это место открыто. | |
dropOffLocations[]. name | string | Название места досрочного голосования или места высадки. Это поле не заполняется для избирательных участков. | |
dropOffLocations[]. voterServices | string | Услуги, предоставляемые этим сайтом досрочного голосования или местом высадки. Это поле не заполняется для избирательных участков. | |
dropOffLocations[]. startDate | string | Первая дата, когда можно будет использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
dropOffLocations[]. endDate | string | Последняя дата, когда можно использовать этот участок досрочного голосования или место высадки. Это поле не заполняется для избирательных участков. | |
dropOffLocations[]. latitude | string | Широта места в градусах к северу от экватора. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
dropOffLocations[]. longitude | string | Долгота местоположения в градусах к востоку от нулевого меридиана. Обратите внимание, что это поле может быть недоступно для некоторых местоположений. | |
dropOffLocations[]. sources[] | list | Список источников для этого места. Если указано несколько источников, данные были агрегированы из этих источников. | |
dropOffLocations[].sources[]. name | string | Имя источника данных. | |
dropOffLocations[].sources[]. official | boolean | Поступают ли эти данные из официального правительственного источника. |
Конкурсы
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
contests[] | list | Конкурсы, которые появятся в избирательных бюллетенях избирателя. | |
contests[]. type | string | Тип конкурса. Обычно это «Общий», «Первичный» или «Второй тур» для конкурсов с кандидатами. Для референдумов это будет «Референдум». | |
contests[]. primaryParty | string | Если это партийные выборы, укажите название партии, от которой они состоятся. | |
contests[]. electorateSpecifications | string | Описание любых дополнительных требований для участия в голосовании в этом конкурсе. | |
contests[]. special | string | «Да» или «Нет» в зависимости от того, проводится ли конкурс вне обычного избирательного цикла. | |
contests[]. ballotTitle | string | Официальное название в бюллетене для голосования этого конкурса, если оно доступно. | |
contests[]. office | string | Название офиса для этого конкурса. | |
contests[]. level[] | list | Уровни правительства, офис которых будет участвовать в этом конкурсе. Их может быть более одного в случаях, когда юрисдикция эффективно действует на двух разных уровнях управления; например, мэр округа Колумбия действует на locality уровне, но также эффективно и на administrativeArea2 , и administrativeArea1 . Допустимые значения включают в себя:
| |
contests[]. roles[] | list | Роли, для которых выполняет данный конкурс. Роли не должны быть исчерпывающими или точно определять весь набор обязанностей данного офиса, а представляют собой приблизительные категории, которые полезны для общего выбора или сортировки списка офисов. Допустимые значения включают в себя:
| |
contests[]. district | nested object | Информация об избирательном округе, в котором проводится данный конкурс. | |
contests[].district. name | string | Название района. | |
contests[].district. scope | string | Географический охват этого района. Если не указано, география района неизвестна. Один из: национальный, в масштабе штата, в Конгрессе, штат Верхний, штат Нижний, в масштабе округа, судебный, школьный совет, весь город, городок, совет округа, городской совет, приход, специальный Приемлемые значения:
| |
contests[].district. id | string | Идентификатор этого района относительно его области действия. Например, 34-й округ Сената штата будет иметь идентификатор «34» и область действия stateUpper. | |
contests[]. numberElected | long | Число кандидатов, которые будут избраны на должность в этом конкурсе. | |
contests[]. numberVotingFor | long | Число кандидатов, за которых избиратель может проголосовать в этом конкурсе. | |
contests[]. ballotPlacement | long | Число, определяющее место этого конкурса в бюллетенях избирателей. | |
contests[]. candidates[] | list | Выбор кандидатов на этот конкурс. | |
contests[].candidates[]. name | string | Имя кандидата. | |
contests[].candidates[]. party | string | Полное наименование партии, членом которой является кандидат. | |
contests[].candidates[]. candidateUrl | string | URL-адрес веб-сайта предвыборной кампании кандидата. | |
contests[].candidates[]. phone | string | Номер голосового телефона предвыборного штаба кандидата. | |
contests[].candidates[]. photoUrl | string | URL-адрес фотографии кандидата. | |
contests[].candidates[]. email | string | Адрес электронной почты предвыборной кампании кандидата. | |
contests[].candidates[]. orderOnBallot | long | Порядок появления кандидата в избирательном бюллетене для данного конкурса. | |
contests[].candidates[]. channels[] | list | Список известных (социальных) каналов этого кандидата. | |
contests[].candidates[].channels[]. type | string | Тип канала. Ниже приводится список типов каналов, но он не является исчерпывающим. Дополнительные типы каналов могут быть добавлены позже. Один из:
| |
contests[].candidates[].channels[]. id | string | Уникальный общедоступный идентификатор канала кандидата. | |
contests[]. referendumTitle | string | Название референдума (например, «Предложение 42»). Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumSubtitle | string | Краткое описание референдума. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumUrl | string | Ссылка на референдум. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumBrief | string | Указывает краткое описание референдума, которое обычно находится в бюллетене под заголовком, но над текстом. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumText | string | Полный текст референдума. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumProStatement | string | Заявление в пользу референдума. Это не обязательно фигурирует в бюллетенях для голосования. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumConStatement | string | Заявление против референдума. Это не обязательно фигурирует в бюллетенях для голосования. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumPassageThreshold | string | Порог голосов, необходимый для прохождения референдума, например, «две трети». Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumEffectOfAbstain | string | Указывает, какое влияние окажет воздержание (не голосование) на предложение (т. е. считается ли воздержание голосованием против него). Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. referendumBallotResponses[] | list | Набор ответов на референдум. Ответ на бюллетень представляет собой строку на бюллетене. Типичные примеры могут включать «да» или «нет» для референдумов или имя судьи для конкурса на удержание. Это поле заполняется только для конкурсов типа «Референдум». | |
contests[]. sources[] | list | Список источников для этого конкурса. Если указано несколько источников, данные были агрегированы из этих источников. | |
contests[].sources[]. name | string | Имя источника данных. | |
contests[].sources[]. official | boolean | Поступают ли эти данные из официального правительственного источника. |
Представители избирательной комиссии
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
state[] | list | Информация о местных выборах для штата, в котором голосует избиратель. Для США в этом массиве будет только один элемент. | |
state[]. name | string | Название юрисдикции. | |
state[]. electionAdministrationBody | nested object | Орган по проведению выборов в этом районе. | |
state[].electionAdministrationBody. name | string | Название этого избирательного административного органа. | |
state[].electionAdministrationBody. electionInfoUrl | string | URL-адрес, предоставленный этим административным органом для поиска информации о всеобщих выборах. | |
state[].electionAdministrationBody. electionRegistrationUrl | string | URL-адрес, предоставленный этим административным органом для поиска способа регистрации для голосования. | |
state[].electionAdministrationBody. electionRegistrationConfirmationUrl | string | URL-адрес, предоставленный этим административным органом для подтверждения того, что избиратель зарегистрирован для голосования. | |
state[].electionAdministrationBody. electionNoticeText | string | Текст уведомления в последнюю минуту или экстренного сообщения, предоставленный этим административным органом. | |
state[].electionAdministrationBody. electionNoticeUrl | string | URL-адрес, предоставленный этим административным органом для получения дополнительной информации, связанной с уведомлением в последнюю минуту или экстренным сообщением. | |
state[].electionAdministrationBody. absenteeVotingInfoUrl | string | URL-адрес, предоставленный этим административным органом для получения информации о заочном голосовании. | |
state[].electionAdministrationBody. votingLocationFinderUrl | string | URL-адрес, предоставленный этим административным органом для поиска мест для голосования. | |
state[].electionAdministrationBody. ballotInfoUrl | string | URL-адрес, предоставленный этим административным органом для предоставления избирателю информации о конкурсе. | |
state[].electionAdministrationBody. electionRulesUrl | string | URL-адрес, предоставленный этим административным органом и описывающий избирателю правила выборов. | |
state[].electionAdministrationBody. voter_services[] | list | Описание услуг, которые может предоставлять этот административный орган. | |
state[].electionAdministrationBody. hoursOfOperation | string | Описание режима работы данного административного органа. | |
state[].electionAdministrationBody. correspondenceAddress | nested object | Почтовый адрес этого административного органа. | |
state[].electionAdministrationBody.correspondenceAddress. locationName | string | Название локации. | |
state[].electionAdministrationBody.correspondenceAddress. line1 | string | Название улицы и номер этого адреса. | |
state[].electionAdministrationBody.correspondenceAddress. line2 | string | Вторая строка адрес, если необходимо. | |
state[].electionAdministrationBody.correspondenceAddress. line3 | string | Третья строка адреса, если необходимо. | |
state[].electionAdministrationBody.correspondenceAddress. city | string | Город или поселок для адреса. | |
state[].electionAdministrationBody.correspondenceAddress. state | string | Двухбуквенное сокращение адреса в США. | |
state[].electionAdministrationBody.correspondenceAddress. zip | string | Почтовый индекс адреса США. | |
state[].electionAdministrationBody. physicalAddress | nested object | Физический адрес данного административного органа. | |
state[].electionAdministrationBody.physicalAddress. locationName | string | Название локации. | |
state[].electionAdministrationBody.physicalAddress. line1 | string | Название улицы и номер этого адреса. | |
state[].electionAdministrationBody.physicalAddress. line2 | string | Вторая строка адрес, если нужно. | |
state[].electionAdministrationBody.physicalAddress. line3 | string | Третья строка адреса, если необходимо. | |
state[].electionAdministrationBody.physicalAddress. city | string | Город или поселок для адреса. | |
state[].electionAdministrationBody.physicalAddress. state | string | Двухбуквенное сокращение адреса в США. | |
state[].electionAdministrationBody.physicalAddress. zip | string | Почтовый индекс адреса США. | |
state[].electionAdministrationBody. electionOfficials[] | list | Должностные лица по выборам данного избирательного административного органа. | |
state[].electionAdministrationBody.electionOfficials[]. name | string | Полное имя должностного лица, ответственного за выборы. | |
state[].electionAdministrationBody.electionOfficials[]. title | string | Должность должностного лица, ответственного за выборы. | |
state[].electionAdministrationBody.electionOfficials[]. officePhoneNumber | string | Рабочий телефон представителя избирательной комиссии. | |
state[].electionAdministrationBody.electionOfficials[]. faxNumber | string | Номер факса представителя избирательной комиссии. | |
state[].electionAdministrationBody.electionOfficials[]. emailAddress | string | Адрес электронной почты представителя избирательной комиссии. | |
state[]. local_jurisdiction | nested object | Город или округ, предоставляющий информацию о выборах для этого избирателя. Этот объект может иметь те же элементы, что и состояние. | |
state[]. sources[] | list | Список источников по этой области. Если указано несколько источников, данные были агрегированы из этих источников. | |
state[].sources[]. name | string | Имя источника данных. | |
state[].sources[]. official | boolean | Поступают ли эти данные из официального правительственного источника. |