はじめに
Address Validation API は、住所を受け入れるサービスです。住所の構成要素を特定して検証します。また、郵送用の住所を標準化し、その住所に最適な既知の緯度と経度の座標を見つけます。必要に応じて、米国とプエルトリコの住所に対して Coding Accuracy Support System（CASS™）を有効にできます。Address Validation API を使用する理由
Address Validation API を使用すると、配達の予測可能性を高め、配達の失敗を減らすことができるため、カスタマー エクスペリエンスを向上させることができます。これは、不正なアドレスをキャッチし、アドレスの特性をより正確に把握することで実現します。
その他の考慮事項
Address Validation API は、住所の正確性を検証します。Geocoding API は、住所を緯度と経度の座標に変換します。詳細な比較については、アーキテクチャ センターの Google Maps Platform を使用して位置情報の検証機能を構築するをご覧ください。
個々の住所コンポーネントを検証する必要がない場合や、建物の入口、建物の輪郭、ナビゲーション ポイントなどのハイパーローカルな目的地の詳細情報が必要な場合は、Geocoding API の方がニーズに合っている可能性があります。
Geocoding API v4 では、建物の入り口、ナビゲーション ポイント、建物の輪郭の座標を返す SearchDestinations メソッドが導入されています。詳しくは、Geocoding API v4 の目的地を検索するセクションをご覧ください。
Address Validation API でできること
Address Validation API を使用すると、住所が実際の場所を指しているかどうかを判断できます。住所が実際の場所を参照していない場合、API は誤りの可能性があるコンポーネントを特定し、お客様に提示して修正を求めることができます。API を使用したワークフローの例を次に示します。
顧客が住所を入力する - 次の画像は、顧客が住所を入力できる基本的なフォームを示しています。これは、購入手続きフローの一部である可能性があります。
アプリが API に住所を送信する - アプリケーションがこの住所を Address Validation API の入力として渡します。
API が住所を検証して標準化する - Address Validation API は、レスポンスで、API が判断した完全な住所を返すか、情報が欠落している場所を示します。
お客様が住所を確認または修正する - API の戻り値に応じて、お客様に次のプロンプトを表示できます。 A. 推奨される住所を確認します。B. 不足している情報を入力します。 C. 住所を修正します。
Address Validation API の仕組み
住所確認では、JSON 本文の形式で住所を含む POST リクエストを受け付けます。住所を個々のコンポーネントに分割し、次の処理を試みます。
- 修正 - 区画データ（該当する場合）などのコンポーネント レベルの検証チェックを提供します。
- Completes - 欠落している住所コンポーネントや誤った住所コンポーネントの推測を試みます。
- 形式 - 住所の構成要素の形式をクリーンアップして標準化します。
リソース
次の表に、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 で使用可能なクライアント ライブラリの一覧については、クライアント ライブラリをご覧ください。
CASS™ について
United States Postal Service®（USPS®）1 は、住所検証サービスのプロバイダを支援し認定するために、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 を使用して大量のアドレスを処理するをご覧ください。
-
Google Maps Platform は、United States Postal Service® の非独占的なライセンシーです。United States Postal Service®、CASS™、CASS Certified™ の各商標は米国郵政公社が所有し、許諾を得て使用しています。↩