Политическая география и выборные представители
API Google Civic Information предлагает информацию о политико-географических подразделениях и избранных представителях по адресам США от федерального до местного уровня. В настоящее время мы имеем охват, приближающийся к 100 % для округов штата, округа и Конгресса, и стремимся превысить 90 % охват для законодательных округов штата. Более низкие уровни, такие как городские и окружные советы, обслуживаются максимально эффективно и со временем будут улучшаться.
Мы ожидаем иметь актуальную информацию обо всех выборных должностных лицах на федеральном уровне, уровне штата и округа, а также о городских чиновниках крупнейшего города в каждом штате США, а также любого города с населением более 250 000 человек. Мы объединяем эти данные из нескольких источников и предоставляем доступную информацию самого высокого качества. Если мы обнаружим проблемы с качеством данных, мы можем прекратить возвращать данные для определенных географических подразделений, выборных должностей или выборных должностных лиц.
Информация для голосования
API Google Civic Information возвращает гражданскую информацию, такую как избирательный участок, место досрочного голосования, контактную информацию местного представителя избирательной комиссии и информацию для голосования, пользователям для выборов, поддерживаемых Проектом информации для голосования .
Доступность данных
- В календаре выборов Проекта информации о голосовании на 2024 год показано ожидаемое освещение выборов, которое будет опубликовано в API Google Civic Information.
Рекомендации разработчика
Мы требуем от всех разработчиков соблюдения следующих правил:
- Соблюдайте условия обслуживания API .
- Используя API, разработчики соглашаются подчиняться любым заголовкам управления кэшем, если таковые имеются. При отсутствии заголовков управления кэшем разработчики соглашаются не кэшировать более 24 часов для мест голосования и информации о конкурсах и более 30 дней для должностных лиц и округов.
- Разработчики, использующие API, должны приложить все усилия, чтобы обеспечить одинаковый опыт для всех пользователей. Мы не допускаем удержаний, A/B-тестирования и подобных экспериментов.
Если вам нужна дополнительная квота для реализации вашего варианта использования, вы можете запросить увеличение для каждого проекта в консоли разработчика . Предоставление дополнительной квоты ограничено и определяется максимальной нормой.
Примечание. Процесс утверждения занимает 1–2 месяца. Соответственно планируйте запросы на увеличение квоты. Чтобы подготовиться к увеличению квот на президентских выборах 2024 года, подайте запросы на квоты до августа.
- Дополнительная квота для Civic Info API предназначена только для поддержки сценариев использования , ориентированных на пользователя . Запросы на увеличение квоты не удовлетворяются для других вариантов использования.
Дополнительные рекомендации по данным
С этими данными особенно сложно работать. Пожалуйста, имейте в виду следующие моменты.
- Представители избирательной комиссии часто пересматривают эти данные в последние несколько недель и даже в последние несколько дней перед выборами. Хорошей идеей будет предупредить пользователей, что им следует проверить информацию перед голосованием.
- Большинство официальных каналов содержат сегменты улиц, а это означает, что сотрудники избирательной комиссии привязывают ряд адресов к избирательным участкам и избирательным участкам. На участках могут быть или не быть зарегистрированы избиратели по этому адресу. Следовательно, для штатов, предоставляющих официальные каналы через Проект информации для голосования, адрес, по которому нет зарегистрированных избирателей, может оказаться успешным.
- Для штатов, не предоставляющих официальную ленту, успешным будет только адрес, по которому есть зарегистрированный избиратель.
- Иногда у нас будет несколько источников одной и той же информации. Мы предоставляем информацию высочайшего качества, доступную для контактной информации официальных лиц местных выборов и информации для голосования. Невозможно переопределить это поведение, кроме как исключить неофициальные источники с помощью параметраofficialSourcesOnly. Что касается информации об избирательных участках, мы всегда отдаем приоритет официальным источникам данных над другими источниками.
- Если мы обнаружим проблемы с качеством данных, мы можем не возвращать данные по конкретному избирательному округу до тех пор, пока проблема не будет решена.
- Если у нас нет данных об адресе, это не обязательно означает, что там никто не зарегистрирован для голосования. Приложения должны направлять пользователей к местным избирательным органам для получения полной информации.
- Выборы автоматически истекают после дня выборов. После этого момента данные о выборах не будут возвращены.
Атрибуция
Указание на Civic Information API не является обязательным. Если разработчик решает использовать Civic Information API и связать пользователей с дополнительной информацией об Civic Information API, мы требуем, чтобы разработчики использовали один из следующих языков атрибуции и веб-страницу, указанную ниже:
- «На базе Civic Information API»
- «Информация для голосования на основе Civic Information API»
- «Информация для голосования на основе Civic Information API»
- «Репрезентативная информация на основе Civic Information API»
- "Узнать больше"
Коды состояния
Вызовы voicerInfoQuery включают поле status , которое устанавливается на success , когда адрес принят. В остальных случаях будет возвращен код ошибки. Общие пояснения к кодам ошибок приведены ниже. Обратите внимание, что информация может быть возвращена, даже если присутствует код ошибки.
| Положение дел | Объяснение |
|---|---|
success | Запрошенный адрес распознается API как действительный адрес. |
noStreetSegmentFound | API на данный момент не располагает информацией о том, к какому избирательному участку и/или округу принадлежит этот адрес. Возможно, мы все еще собираем/обрабатываем новые данные или что по этому адресу нет избирателей, зарегистрировавшихся для голосования. |
addressUnparseable | Запрошенный адрес имеет неправильный формат или не может быть геокодирован (т. е. Google Maps API ничего не знает об этом адресе). |
noAddressParameter | Адрес не был указан. |
multipleStreetSegmentsFound | API не может найти информацию по указанному адресу, но имеет информацию о близлежащих адресах. Пользователю следует связаться с представителем избирательной комиссии для получения дополнительной информации. |
electionOver | Запрошенные выборы завершились. Результаты API для выборов больше не доступны. Сделайте выборный запрос , чтобы найти идентификатор предстоящих выборов. |
electionUnknown | Запрошенный идентификатор выборов недействителен. Сделайте выборный запрос , чтобы найти действительный идентификатор. |
internalLookupFailure | При обработке запроса произошла неизвестная ошибка. |