投票情報
データの保存期間
- Voting Information Project の選挙カレンダーには、Google Civic Information API で公開される選挙の予想される対象範囲が示されています。
デベロッパー ガイドライン
すべてのデベロッパーは、次のガイドラインを遵守する必要があります。
- API 利用規約に沿ったものであること。
- デベロッパーは、API を使用することにより、キャッシュ制御ヘッダーがある場合はそれに従うことに同意します。キャッシュ制御ヘッダーがない場合、デベロッパーは、投票所と選挙に関する情報を 24 時間以上、現職者と選挙区に関する情報を 30 日以上キャッシュに保存しないことに同意します。
- API を使用するデベロッパーは、すべてのユーザーに同じエクスペリエンスを提供できるよう、あらゆる努力を払う必要があります。ホールドバック、A/B テスト、または同様のテストは許可されていません。
ユースケースを有効にするために割り当てを追加する必要がある場合は、デベロッパー コンソールでプロジェクトごとの増加をリクエストできます。割り当ての追加は制限されており、上限があります。
注: 承認プロセスには 1 ～ 2 か月かかるため、デベロッパーは割り当て増加のリクエストをそれに応じて計画することをおすすめします。11 月の選挙の割り当て増加については、8 月末までに割り当てリクエストを送信することを強くおすすめします。
- Civic Info API の追加割り当ては、ユーザー向け のユースケースをサポートすることを目的としています。他のユースケースでは、割り当て増加のリクエストは許可されません。
その他のデータ ガイドライン
このデータは特に扱いにくいものです。 次の点に注意してください。
- 選挙管理委員会は、選挙の数週間前、さらには数日前にも、このデータを頻繁に改訂します。 投票前に再度確認するようユーザーに注意を促すことをおすすめします。
- ほとんどの公式フィードには街区が含まれています。つまり、選挙管理委員会は、住所の範囲を選挙区と投票所に結び付けています。 これらの住所に有権者が登録されている場合とそうでない場合があります。 そのため、Voting Information Project を通じて公式フィードを提供している州では、有権者が登録されていない住所でも成功が返されることがあります。
- 公式フィードを提供していない州では、有権者が登録されている住所でのみ成功が返されます。
- 同じ情報に対して複数のソースが存在する場合があります。地域の選挙管理委員会の連絡先情報と投票用紙の情報については、利用可能な最高品質の情報を提供します。 この動作をオーバーライドする方法はありません。ただし、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 |
リクエストの処理中に不明なエラーが発生しました。 |