Address Validation API は、住所を受け入れるサービスです。住所コンポーネントを識別し、検証します。また、郵送用に住所を標準化し、その住所に最適な既知の緯度と経度の座標を検出します。必要に応じて、米国とプエルトリコの住所で Coding Accuracy Support System(CASSTM)を有効にできます。
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 リクエストを受け入れます。住所を個々のコンポーネントに分割し、次の確認と修正を行います。
- 正解 - 区画データ(利用可能な場合)を含むコンポーネント レベルの検証チェックを行います。
- 完了 - 住所要素が欠落しているか、正しくないと推定します。
- 適切なフォーマット - 住所コンポーネントの形式をクリーンアップして標準化します。
デモをお試しください。Address Validation API の動作を確認できます。
リソース
次の表は、Address Validation API で使用可能なリソースと、この API から返されるデータをまとめたものです。具体的な詳細については、Address Validation API リファレンスをご覧ください。
データリソース | 返されるデータ |
---|---|
JSON 形式の住所コンポーネント。 アドレスを検証するをご覧ください。 |
検証済みの完全な住所(可能な場合)。 各住所コンポーネントの検証ステータス。 住所を入力できる場合:
検証レスポンスについてをご覧ください。 |
Address Validation API の使用方法
1 | デモを試す | さまざまな住所フォーム(正しい住所フォームと誤った住所フォームの両方)を使用して、デモを確認します。このデモでは、サービスからの戻り値と JSON 形式の API レスポンスの両方を調査できます。 |
2 | カバレッジを確認する | Address Validation API のサポート対象国または地域については、対象範囲の詳細をご覧ください。 |
3 | セットアップする | Google Cloud プロジェクトの設定から始めて、次の手順を完了します。 |
4 | 住所確認をリクエストする | シンプルな住所から始めて、CASS を有効にすると精度が向上します(米国と PR の住所のみ)。住所確認をリクエストするをご覧ください。 |
5 | 回答を処理する | Address Validation API レスポンスには 2 つのプロパティがあり、それぞれを別の方法で使用できます。基本的なレスポンスについてをご覧ください。 |
6 | 検証の精度を向上させる | Address Validation API のレスポンスに関するフィードバックを提供すると、住所の精度向上に役立ちます。更新された住所を処理するをご覧ください。 |
利用可能なクライアント ライブラリ
Address Validation API で使用可能なクライアント ライブラリのリストについては、クライアント ライブラリをご覧ください。
CASSTM について
米国郵便公社(USPS®)1 は、住所検証プロバイダをサポートして認定するために、コーディング精度サポート システム(CASSTM)を維持しています。Address Validation API などの CASS CertifiedTM サービスでは、住所が不足している情報の入力、標準化、更新を行い、最新の正確な住所を取得する機能が確認されています。
CASS はデフォルトでは有効になっておらず、「US」リージョンと「PR」リージョンでのみサポートされます。CASS を有効にするには、検証リクエストの一部として enableUspsCass
を true
に設定します。詳細については、アドレスを検証するをご覧ください。
Google による USPS サービスの利用の一環として、USPS では人為的に作成された住所のリクエストを評価します。入力住所が人為的に作成されたものであると USPS が判断した場合、Google はお客様の住所確認を停止する必要があります。また、お客様の連絡先情報(名前と住所)、関連する入力住所、使用状況の集計データを USPS に報告する必要があります。この API を使用すると、サービス固有の規約に同意したことになります。
次のステップ
- よくある質問を確認する: よくある質問をご覧ください。
- サービス提供地域を確認する: 対象の国と地域の詳細をご覧ください。
- 大量の住所を処理する: Address Validation API を使用して大量の住所を処理するをご覧ください。
-
Google Maps Platform は、米国郵便公社の非独占的なライセンシーです。米国郵便公社の商標は米国郵便公社が所有し、同社の許可を得て使用しています: United States Postal Service®、CASSTM、CASS CertifiedTM↩