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 を使用したワークフローの例を次に示します。
お客様が住所を入力する – 以下の画像は、購入手続きでユーザーが住所を入力できる簡単なフォームを示しています。
アプリがアドレスを API に送信する – アプリはこのアドレスを入力として Address Validation API に渡します。
API による住所の検証と標準化 - レスポンスでは、Address Validation API が API が決定した完全な住所を返すか、情報の欠落している場所を示します。
お客様が推奨される住所を訂正または確認する - API から返される情報に応じて、お客様に次のプロンプトを提供できます。
ユーザーに確認してもらうための推奨住所を提示します。
不足している情報を追加するよう、お客様にご案内します。
情報が不足しているか間違っているために API が入力アドレスを検証できない場合は、ユーザーに住所の修正を求めるメッセージを表示します。
Address Validation API の仕組み
アドレス検証は、JSON 本文形式のアドレスを含む POST リクエストを受け入れます。アドレスは個々のコンポーネントに分割され、次のチェックと修正が行われます。
- 区画データ（該当する場合）などのコンポーネント レベルの検証チェックを提供します。
- 住所コンポーネントがない、または推測されない。
- 住所コンポーネントの形式をクリーンアップして標準化しました。
デモを試して、Address Validation API の実例をご確認ください。
リソース
次の表は、Address Validation API で使用可能なリソースと返されるデータをまとめたものです。詳細については、Address Validation API リファレンスをご覧ください。
| データリソース | 返されたデータ |
|---|---|
|
JSON 形式のアドレス コンポーネント。 住所を検証するをご覧ください。 |
確認済みの完全な住所（可能な場合） 各住所コンポーネントの検証ステータス。 住所を使用できる地域:
検証レスポンスについてをご覧ください。 |
Address Validation API の使用方法
| 1 | デモを試す | さまざまなアドレス形式（正解と不正解の両方）でデモを探索します。 このデモは、サービスの戻り値と JSON 形式の API レスポンスの両方を確認するのに役立ちます。 |
| 2 | セットアップ。 | Google Cloud プロジェクトの設定から始めて、以下の手順を完了します。 |
| 3 | 住所の検証 | 単純なアドレスから始めます。さらに精度を高めるため、CASS を有効にします（米国と PR のアドレスの場合のみ）。住所を検証するをご覧ください。 |
| 4 | レスポンスを処理する | Address Validation API のレスポンスには 2 つのプロパティがあり、各プロパティはそれぞれ異なります。検証レスポンスについてをご覧ください。 |
| 5 | 検証精度の向上 | 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 は、入力アドレスが人為的に作成されたものであると判断した場合、お客様の住所の検証を停止し、お客様の連絡先情報（名前と住所）、関連する入力アドレス、および集計された使用状況データを USPS に報告する必要があります。本 API を使用することにより、サービス固有の利用規約に同意したことになります。
次のステップ
- よくある質問を確認する: よくある質問をご覧ください。
- サービス提供地域を確認する: 国と地域の適用範囲の詳細をご覧ください。
- 大量の住所を処理する: Address Validation API を使用して大量の住所を処理するをご覧ください。