デベロッパー データ ガイドライン

投票情報

Google Civic Information API は、投票情報プロジェクトでサポートされている選挙について、投票所、早期投票所、地域の選挙担当者の連絡先情報、投票用紙情報などの市民情報をユーザーに返します。

データの可用性

デベロッパー ガイドライン

すべてのデベロッパーは、以下のガイドラインに準拠する必要があります。

  • API の利用規約に準拠します。
  • API を使用すると、デベロッパーはキャッシュ制御ヘッダー（存在する場合）に従うことに同意したものと見なされます。キャッシュ制御ヘッダーがない場合、デベロッパーは投票所と選挙情報については 24 時間以内、公職者と選挙区については 30 日以内にキャッシュに保存しないことに同意します。
  • API を使用するデベロッパーは、すべてのユーザーに同じエクスペリエンスを提供できるようあらゆる努力を払う必要があります。ホールドバック、A/B テスト、または同様のテストは許可されません。

  • ユースケースを有効にするために追加の割り当てが必要な場合は、デベロッパー コンソールでプロジェクトごとの増加をリクエストできます。追加割り当てのプロビジョニングには制限があり、最大許容量が適用されます。

    注: 承認プロセスには 1 ～ 2 か月かかります。割り当ての増加リクエストは、それに応じて計画してください。2024 年の大統領選挙の割り当て増加に備えて、8 月までに割り当てリクエストを送信してください。

  • Civic Info API の追加割り当ては、ユーザー向けのユースケースをサポートすることを目的としています。他のユースケースでは、割り当て増加リクエストは承認されません。

その他のデータ ガイドライン

このデータは特に扱いにくいものです。以下の点にご注意ください。

  • 選挙管理委員会は、選挙の数週間前、場合によっては数日前にも、このデータを頻繁に修正します。投票する前にもう一度確認することをユーザーに警告することをおすすめします。
  • ほとんどの公式フィードには道路セグメントが含まれています。つまり、選挙管理者は、一連の住所を選挙区や投票所と関連付けています。範囲内の住所に登録されている有権者がいる場合も、いない場合もあります。そのため、投票情報プロジェクトを通じて公式フィードを提供している州では、登録有権者がいない住所でも成功が返されることがあります。
  • 公式フィードを提供していない州では、登録有権者がいる住所のみが成功として返されます。
  • 同じ情報の複数のソースが存在することもあります。Google は、地方選挙の担当者の連絡先情報と投票情報について、入手可能な最高品質の情報を掲載しています。この動作をオーバーライドする方法はありません。officialSourcesOnly パラメータを使用して非公式ソースを除外する以外に方法はありません。投票所の情報については、他のソースよりも公式データソースを優先しています。
  • データ品質の問題が検出された場合は、問題が解決するまで、特定の選挙区のデータが返されないことがあります。
  • 住所に関するデータがない場合、その住所に登録されている有権者がいないとは限りません。アプリでは、詳細な情報についてはユーザーを地域の選挙管理委員会に誘導する必要があります。
  • 選挙は投票日を過ぎると自動的に期限切れになります。その後、その選挙に関するデータは返されません。

アトリビューション

Civic Information API へのアトリビューションは任意です。デベロッパーが Civic Information API を帰属表示し、Civic Information API の詳細情報にユーザーをリンクする場合は、以下の帰属表示の文言オプションのいずれかを使用し、下記のウェブページにリンクする必要があります。

  • 「Civic Information API を利用」
  • 「Civic Information API による投票情報」
  • 「Civic Information API による投票情報」
  • [詳細]

ステータス コード

voterInfoQuery の呼び出しには、住所が承認されると success に設定される status フィールドが含まれます。それ以外の場合は、エラーコードが返されます。一般的なエラーコードの説明は次のとおりです。エラーコードが存在する場合でも、情報が返されることがあります。

ステータス 説明
success リクエストされた住所が API によって有効な住所として認識される。
noStreetSegmentFound 現在、この API には、この住所がどの選挙区に属しているかに関する情報はありません。新しいデータの収集や処理がまだ完了していないか、この住所に投票登録している有権者がいない可能性があります。
addressUnparseable リクエストされた住所の形式が正しくないか、ジオコーディングできない（Google Maps API にこの住所に関する情報がない）。
noAddressParameter 住所が指定されていません。
multipleStreetSegmentsFound API は指定された住所の情報を見つけることができませんが、近くの住所に関する情報はあります。詳しくは、選挙管理委員会にお問い合わせください。
electionOver リクエストされた選挙は終了しています。選挙の API 結果は利用できなくなりました。electionQuery を作成して、今後の選挙の ID を検索します。
electionUnknown リクエストされた選挙 ID が無効です。electionQuery を作成して有効な ID を検索します。
internalLookupFailure リクエストの処理中に不明なエラーが発生しました。