Address Validation API の概要

Address Validation API は、住所を受け付けるサービスです。住所コンポーネントを識別して検証します。また、郵送用に住所を標準化し、最も広く知られている緯度と経度の座標を検出します。米国とプエルトリコの住所の場合、Coding Accuracy Support System（CASSTM）を有効にすることもできます。

Address Validation API を使用する理由

Address Validation API を使用すると、配達の予測可能性を高め、配達の失敗を減らすことができるため、カスタマー エクスペリエンスを向上させることができます。これを行うには、不正な住所を検出し、住所の特性の認識を向上させます。

リクエストで個々の住所コンポーネントを検証する必要がない場合は、Geocoding API のほうがニーズに合っている可能性があります。Geocoding API は住所を緯度/経度の座標に変換しますが、Address Validation API は住所の正確性を検証します。詳しくは、後述の Address Validation API の仕組みと Geocoding API の概要をご覧ください。

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 を有効にすると、精度が向上します（米国と PR の住所のみ）。住所確認をリクエストするをご覧ください。
5	回答を処理する	Address Validation API のレスポンスには 2 つのプロパティがあり、それぞれ使用方法が異なります。基本的なレスポンスについてをご覧ください。
6	検証精度を向上させる	Address Validation API のレスポンスに関するフィードバックを提供することで、住所の精度向上にご協力いただけます。住所確認のフィードバックを送信するをご覧ください。

利用可能なクライアント ライブラリ

Address Validation API の利用可能なクライアント ライブラリのリストについては、クライアント ライブラリをご覧ください。

CASSTM について

米国郵政公社（USPS®）¹は、住所検証プロバイダのサポートと認定のために、Coding Accuracy Support System（CASSTM）を維持しています。Address Validation API などの CASS CertifiedTM サービスは、住所にない情報を記入して標準化し、最新の正確な住所が表示されるように更新できる機能が確認されています。

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

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

次のステップ

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