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

投票情報

Google Civic Information API は、Voting Information Project がサポートする選挙について、投票所、期日前投票所、地方選挙管理委員会の連絡先情報、投票用紙などの市民情報をユーザーに返します。

データの可用性

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

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

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

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

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

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

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

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

  • 選挙管理委員会は、選挙の数週間前、さらには数日前にもこのデータを頻繁に更新します。投票前に再度確認するようユーザーに警告することをおすすめします。
  • ほとんどの公式フィードには街区が含まれています。つまり、選挙管理委員会は、一連の住所を区と投票所に結び付けています。これらの範囲に登録されている有権者がいる場合といない場合があります。そのため、Voting Information Project を通じて公式フィードを提供している州では、登録有権者がいない住所でも成功が返されることがあります。
  • 公式フィードを提供していない州では、登録有権者がいる住所のみが成功を返します。
  • 同じ情報に対して複数のソースが存在することもあります。Google は、地方選挙の選挙管理委員会の連絡先情報と投票情報について、入手可能な最高品質の情報を提供しています。この動作をオーバーライドする方法はありません。ただし、officialSourcesOnly パラメータを使用して、非公式のソースを排除することはできます。投票所の情報については、常に他の情報源よりも公式のデータソースを優先します。
  • データ品質の問題が検出された場合、問題が解決されるまで、特定の選挙区のデータが返されないことがあります。
  • 住所に関するデータがない場合でも、その住所に投票登録者がいないとは限りません。アプリでは、完全な情報についてユーザーが地元の選挙管理委員会に問い合わせるよう案内する必要があります。
  • 選挙は、投票日の後に自動的に期限切れになります。それ以降の選挙についてはデータが返されなくなります。

アトリビューション

Civic Information API への帰属は任意です。デベロッパーが Civic Information API を帰属先として選択し、ユーザーを Civic Information API の詳細情報にリンクする場合、デベロッパーは以下の帰属先言語オプションと、以下にリンクされているウェブページのうちの 1 つを使用する必要があります。

  • 「Powered by the Civic Information API」
  • 「投票情報は Civic Information API を利用しています」
  • 「Ballot information powered by the Civic Information API」
  • 「詳細」

ステータス コード

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

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