Address Validation API の概要

はじめに

Address Validation API は、アドレスを受け入れるサービスです。住所の構成要素を識別して検証します。また、郵送用の住所を標準化し、その住所に最適な既知の緯度と経度の座標を見つけます。必要に応じて、米国とプエルトリコの住所に対して Coding Accuracy Support System（CASS™）を有効にできます。

Address Validation API を使用する理由

Address Validation API を使用すると、配達の予測可能性を高め、配達の失敗を減らすことで、カスタマー エクスペリエンスを向上させることができます。これは、不正なアドレスをキャッチし、アドレスの特性をより適切に認識することで実現します。

個々のアドレス コンポーネントを検証する必要がない場合は、Geocoding API の方がニーズに合っている可能性があります。Geocoding API は、住所を緯度と経度の座標に変換します。Address Validation API は、住所の正確性を検証します。詳細な比較については、アーキテクチャ センターの Google Maps Platform を使用して位置情報の検証機能を構築するをご覧ください。

Address Validation API でできること

inputデモを試す

Address Validation API を使用すると、住所が実際の場所を指しているかどうかを判断できます。住所が実際の場所を参照していない場合、API は誤りの可能性があるコンポーネントを特定できます。このコンポーネントをお客様に提示して、修正を依頼できます。API を使用したワークフローの例を次に示します。

1. 顧客が住所を入力する - 次の画像は、顧客が住所を入力できる基本的なフォームを示しています。このフォームは、購入手続きフローの一部として表示される可能性があります。

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

   

3. API が住所を検証して標準化する - Address Validation API は、レスポンスで、API が判断した完全な住所を返すか、情報が欠落している場所を示します。

4. お客様が住所を確認または修正する - API の戻り値に応じて、お客様に次のプロンプトを表示できます。 A. 推奨される住所を確認します。B. 不足している情報を入力します。 C. 住所を修正します。

   

Address Validation API の仕組み

住所確認は、JSON 本文の形式で住所を含む POST リクエストを受け入れます。住所を個々のコンポーネントに分割し、次の処理を試みます。

• 修正 - 区画データ（該当する場合）などのコンポーネント レベルの検証チェックを提供します。
• Completes - 欠落している住所コンポーネントや正しくない住所コンポーネントの推測を試みます。
• 形式 - 住所の構成要素の形式をクリーンアップして標準化します。

リソース

次の表に、Address Validation API で使用可能なリソースと、返されるデータの概要を示します。詳細については、住所確認 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 で使用可能なクライアント ライブラリの一覧については、クライアント ライブラリをご覧ください。

CASS™ について

United States Postal Service®（USPS®）¹ は、住所検証サービスのプロバイダを支援し認定するために、Coding Accuracy Support System（CASS™）を運営しています。Address Validation API などの CASS Certified™ サービスは、住所に不足している情報を補完し、標準化して更新し、最新かつ最も正確な住所を提供できることが確認されています。

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

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

次のステップ

• デモを試す: [デモ] に移動します。
• 対象地域を確認する: 国と地域の対象範囲の詳細をご覧ください。
• 最初の検証リクエストを試す: 住所検証リクエストを送信するに移動します。
• 大量のアドレスを処理する: Address Validation API を使用して大量のアドレスを処理するをご覧ください。