このページは Cloud Translation API によって翻訳されました。

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

政治地理と選挙議員

Google Civic Information API は、連邦レベルから地方レベルまで、米国の住所の政治的地理的区域と選出代理人に関する情報を提供します。現在、州、郡、下院選挙区のカバレッジは 100% に近づき、州立法区のカバレッジは 90% を超えることを目指しています。市区町村や郡などの下位レベルの行政区分はベストエフォート方式で対応され、時間の経過とともに改善されます。

Google は、連邦、州、郡のレベルで選出されたすべての職員と、米国の各州最大の都市および人口 25 万人以上の都市の市役員に関する最新情報を提供する予定です。こうしたデータを複数の情報源から集約し、利用可能な最高品質の情報を提供しています。データ品質の問題が見つかった場合は、特定の地域の行政区、公選職、公選された役職者のデータを返さなくなることがあります。

投票情報

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

データの可用性

Voting Information Project 2024 Elections Calendar には、Google Civic Information API で公開される選挙の予想対象範囲が示されています。

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

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

API 利用規約を遵守します。
キャッシュ制御ヘッダーがある場合、デベロッパーは API を使用して、そのヘッダーに従うことに同意したものとみなされます。キャッシュ制御ヘッダーがない場合、デベロッパーは投票場所とコンテスト情報を 24 時間以上、役員と選挙区については 30 日間を超えてキャッシュに保存しないことに同意します。
API を使用するデベロッパーは、すべてのユーザーが同じエクスペリエンスを提供できるよう最善を尽くす必要があります。ホールドバック、A/B テストなどのテストは許可されません。
ユースケースを有効にするために追加の割り当てが必要な場合は、Developer Console でプロジェクトごとの割り当ての増加をリクエストできます。追加の割り当てのプロビジョニングには上限があり、上限が適用されます。

注: 承認プロセスには 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 を活用した投票情報」
「Civic Information API を活用した代表的な情報」
「詳細」

ステータスコード

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

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

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