Address Validation API を使用する理由
Address Validation API を使用すると、配達の予測可能性を高め、配信エラーを減らし、カスタマー エクスペリエンスを向上させることができます。具体的には、不正な住所を検出し、住所の特性の認識精度を高めます。
個々の住所コンポーネントを検証する必要がない場合は、Geocoding API の方がニーズに合う可能性があります。Geocoding API は住所を緯度と経度の座標に変換しますが、Address Validation API は住所の正確性を検証します。詳細な比較については、アーキテクチャ センターの Google Maps Platform を使用した位置検証機能の構築をご覧ください。
Address Validation API でできること
Address Validation API を使用すると、住所が実際の場所を指しているかどうかを判断できます。住所が実在の場所のものではない場合、API は誤っている可能性があるコンポーネントを識別し、お客様に提示して修正できます。API を使用したワークフローの例を次に示します。
ユーザーが住所を入力する – 次の画像は、ユーザーが住所を入力できる簡単なフォームを示しています。これは、購入手続きフローの一環です。
アプリが API に住所を送信する - アプリケーションは、入力としてこの住所を Address Validation API に渡します。
API による住所の検証と標準化 – Address Validation API は、API によって決定された完全な住所を返すか、情報が抜けている場所を示します。
お客様が推奨住所を修正または確認する - API の戻り値に応じて、次のプロンプトをお客様に表示できます。
お客様に確認していただくために、推奨される住所を提示します。
不足している情報を追加するよう、お客様に促します。
情報が不足しているか間違っているために API が入力された住所を検証できない場合は、ユーザーに住所の修正を求めます。
Address Validation API の仕組み
住所検証は、住所が JSON 本文の形式である POST リクエストを受け入れます。住所を個々のコンポーネントに分割してから、次のチェックと修正を行います。
- 正解 - 区画データ(該当する場合)などのコンポーネント レベルの検証チェックを行います。
- 完了 - 欠落している住所コンポーネントや不正確な住所コンポーネントを推測しようと試みます。
- Well-formatted - 住所コンポーネントの形式をクリーンアップして標準化します。
デモで、Address Validation API の動作を確認できます。
関連情報
次の表は、Address Validation API で利用可能なリソースと返されるデータをまとめたものです。詳しくは、Address Validation API リファレンスをご覧ください。
データリソース | 返されたデータ |
---|---|
JSON 形式の住所コンポーネント。 アドレスを検証するをご覧ください。 |
正確で完全な住所(可能な場合)。 各住所コンポーネントの検証ステータス。 住所が利用可能な場合:
検証レスポンスについてをご覧ください。 |
Address Validation API の使用方法
1 | デモを試す | 正しい住所と誤った住所の両方のフォームを使用したデモをご覧ください。このデモは、サービスからの戻り値と JSON 形式の API レスポンスの両方を調べる便利な方法を提供します。 |
2 | カバレッジを確認する | 対応範囲の詳細で、Address Validation API が対応している国 / 地域をご確認ください。 |
3 | セットアップする | Google Cloud プロジェクトの設定から始めて、次の手順を完了します。 |
4 | 住所確認をリクエストする | 単純な住所から始めて、CASS を有効にすると精度が向上します(米国とプエルトリコの住所のみ)。住所確認をリクエストするをご覧ください。 |
5 | 回答を処理する | Address Validation API のレスポンスには 2 つのプロパティがあり、それぞれを異なる方法で使用できます。基本的なレスポンスについてをご覧ください。 |
6 | 検証精度を向上させる | Address Validation API のレスポンスに関するフィードバックを提供すると、住所の精度向上に役立ちます。住所確認のフィードバックを送信するをご覧ください。 |
利用可能なクライアント ライブラリ
Address Validation API で使用可能なクライアント ライブラリのリストについては、クライアント ライブラリをご覧ください。
CASSTM について
米国郵便公社(USPS®)1 は、住所検証プロバイダをサポートし、認定するために Coding Accuracy Support System(CASSTM)を維持しています。Address Validation API などの CASS CertifiedTM サービスは、住所にない情報の入力、標準化、更新を行い、最新かつ正確な住所を取得できることが確認されています。
CASS はデフォルトでは有効になっておらず、「US」リージョンと「PR」リージョンでのみサポートされます。CASS を有効にするには、検証リクエストの一部として enableUspsCass
を true
に設定します。詳細については、アドレスを検証するをご覧ください。
USPS サービスの利用の一環として、USPS では人為的に作成された住所に関するリクエストを審査しています。入力された住所が人為的に作成されたものであると USPS が判断した場合、Google はお客様の住所の検証を中止し、お客様の連絡先情報(名前と住所)、関連する入力住所、使用状況の集計データを USPS に報告する必要があります。API を使用すると、これらのサービス固有の利用規約に同意したことになります。
次のステップ
- よくある質問を確認する: よくある質問をご覧ください
- サポート範囲を確認する: 国と地域のサポート範囲の詳細をご覧ください。
- 大量の住所を処理する: Address Validation API を使用して大量の住所を処理するを参照
-
Google Maps Platform は米国郵政公社の非独占的なライセンシーです。米国郵便公社の商標は米国 郵便局が所有し、許諾を得て使用しています: United States Postal Service®、CASSTM、CASS CertifiedTM ↩