Address Validation API の概要

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 を使用したサンプル ワークフローを次に示します。

1. お客様が住所を入力する – 次の画像は、お客様が住所を入力できるシンプルなフォームを示しています（購入手続きフローの一環など）。
   

2. アプリが API に住所を送信する - アプリケーションはこの住所を入力として Address Validation API に渡します。

3. API が住所を検証して標準化する – Address Validation API は、API によって決定された完全な住所をレスポンスで返すか、情報が欠落している場所を示します。

4. お客様が推奨住所を修正または確認する - 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®）¹ は、住所検証プロバイダをサポートして認定するために、コーディング精度サポート システム（CASSTM）を維持しています。Address Validation API などの CASS CertifiedTM サービスでは、住所が不足している情報の入力、標準化、更新を行い、最新の正確な住所を取得する機能が確認されています。

CASS はデフォルトでは有効になっておらず、「US」リージョンと「PR」リージョンでのみサポートされます。CASS を有効にするには、検証リクエストの一部として enableUspsCass を true に設定します。詳細については、アドレスを検証するをご覧ください。

Google による USPS サービスの利用の一環として、USPS では人為的に作成された住所のリクエストを評価します。入力住所が人為的に作成されたものであると USPS が判断した場合、Google はお客様の住所確認を停止する必要があります。また、お客様の連絡先情報（名前と住所）、関連する入力住所、使用状況の集計データを USPS に報告する必要があります。この API を使用すると、サービス固有の規約に同意したことになります。

次のステップ

• よくある質問を確認する: よくある質問をご覧ください。
• サービス提供地域を確認する: 対象の国と地域の詳細をご覧ください。
• 大量の住所を処理する: Address Validation API を使用して大量の住所を処理するをご覧ください。