Руководство по данным для разработчиков

Информация о голосовании

API Google Civic Information предоставляет пользователям информацию о выборах, проводимых при поддержке проекта Voting Information Project , такую ​​как адреса избирательных участков, места для досрочного голосования, контактную информацию местных избирательных чиновников и информацию о бюллетенях.

Доступность данных

Руководство для разработчиков

Мы требуем от всех разработчиков соблюдения следующих правил:

  • Соблюдайте условия использования API .
  • Используя API, разработчики обязуются соблюдать все заголовки управления кэшированием, если таковые имеются. При отсутствии заголовков управления кэшированием разработчики обязуются не кэшировать информацию о местах голосования и результатах выборов более 24 часов и информацию о должностных лицах и округах более 30 дней.
  • Разработчики, использующие API, должны прилагать все усилия для обеспечения одинакового пользовательского опыта для всех пользователей. Мы не допускаем задержек, A/B-тестирования или подобных экспериментов.

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

    Примечание: Процесс утверждения занимает 1-2 месяца. Планируйте свои запросы на увеличение квот соответствующим образом. Чтобы подготовиться к увеличению квот на президентских выборах 2024 года, подайте запросы на квоты до августа.

  • Дополнительная квота для API Civic Info предназначена только для поддержки сценариев использования , ориентированных на пользователей . Запросы на увеличение квоты для других сценариев использования не удовлетворяются.

Дополнительные рекомендации по обработке данных

Работа с этими данными представляет собой особую сложность. Пожалуйста, учитывайте следующие моменты.

  • Избирательные комиссии часто пересматривают эти данные в последние несколько недель и даже в последние несколько дней перед выборами. Целесообразно предупредить пользователей о необходимости проверить данные перед голосованием.
  • Большинство официальных информационных потоков содержат данные по улицам, то есть сотрудники избирательных комиссий связывают ряд адресов с избирательными участками и пунктами голосования. В этих диапазонах могут быть или не быть зарегистрированных избирателей. Следовательно, для штатов, предоставляющих официальные информационные потоки через Проект информации о голосовании, адрес, по которому нет зарегистрированных избирателей, может быть признан успешным.
  • Для штатов, не предоставляющих официальную информацию, успешные результаты будут получены только по адресам, по которым зарегистрирован избиратель.
  • Иногда у нас может быть несколько источников одной и той же информации. Мы предоставляем информацию самого высокого качества, включая контактные данные местных должностных лиц, ответственных за проведение выборов, и информацию о бюллетенях. Изменить это поведение можно только путем исключения неофициальных источников с помощью параметра officialSourcesOnly. Что касается информации о местах голосования, мы всегда отдаем приоритет официальным источникам данных перед другими.
  • Если мы обнаружим проблемы с качеством данных, мы можем не предоставлять данные по конкретному избирательному округу до тех пор, пока проблема не будет решена.
  • Отсутствие данных по адресу не обязательно означает, что по этому адресу никто не зарегистрирован для голосования. Приложения должны направлять пользователей к местным избирательным комиссиям для получения полной информации.
  • Результаты выборов автоматически теряют актуальность после дня голосования. После этого данные по выборам больше не предоставляются.

Атрибуция

Указание ссылки на API гражданской информации является необязательным. Если разработчик решит указать ссылку на API гражданской информации и предоставить пользователям доступ к дополнительной информации об этом API, мы требуем от разработчиков использовать один из следующих вариантов языка указания ссылки и веб-страницу, ссылки на которые приведены ниже:

  • «Работает на основе API гражданской информации»
  • «Информация о голосовании предоставлена ​​с помощью API гражданской информации»
  • «Информация для голосования предоставлена ​​с помощью API гражданской информации»
  • "Узнать больше"

Коды состояния

При вызове функции voterInfoQuery поле status устанавливается в значение success , если адрес принят. В других случаях возвращается код ошибки. Ниже приведены распространенные пояснения к кодам ошибок. Обратите внимание, что информация может быть возвращена даже при наличии кода ошибки.

Статус Объяснение
success Запрошенный адрес распознается API как действительный.
noStreetSegmentFound В настоящее время API не содержит информации о том, к какому избирательному участку и/или округу относится этот адрес. Возможно, мы все еще получаем/обрабатываем новые данные, или же по этому адресу еще не зарегистрированы избиратели.
addressUnparseable Запрошенный адрес имеет неправильный формат или не может быть геолоцирован (то есть API Google Maps ничего не знает об этом адресе).
noAddressParameter Адрес не был указан.
multipleStreetSegmentsFound API не может найти информацию по указанному адресу, но располагает информацией о ближайших адресах. Пользователю следует обратиться к своему избирательному должностному лицу за дополнительной информацией.
electionOver Запрошенные выборы завершены. Результаты API для выборов больше недоступны. Выполните запрос electionQuery , чтобы найти идентификатор предстоящих выборов.
electionUnknown Запрошенный идентификатор выборов недействителен. Выполните запрос electionQuery , чтобы найти действительный идентификатор.
internalLookupFailure При обработке запроса произошла неуказанная ошибка.