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 で使用できるリソースと、それから返されるデータをまとめたものです。具体的な詳細については、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 について

United States Postal Service®（USPS®）¹ は、住所検証プロバイダをサポートし、認定するために、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 を使用して大量の住所を処理するをご覧ください。