Address Validation API を使用する理由
Address Validation API を使用すると、配達の予測可能性を高め、配達エラーを減らすことができ、カスタマー エクスペリエンスを向上させることができます。そのためには、不正な住所を検出し、住所の特性について理解を深める必要があります。
個々の住所コンポーネントを検証する必要がない場合は、Geocoding API の方がニーズに合っている可能性があります。Geocoding API は、住所を緯度と経度の座標に変換します。Address Validation API は、住所の正確性を検証します。詳細な比較については、アーキテクチャ センターの Google Maps Platform を使用した建物の位置検証機能の構築をご覧ください。
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 | カバレッジを確認する | 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 に設定します。詳細については、住所を検証するをご覧ください。
Google は USPS サービスを利用する一環として、USPS が人工的に作成された住所のリクエストを審査します。USPS が入力住所が人為的に作成されたものであると判断した場合、Google はお客様の住所の検証を停止し、お客様の連絡先情報（名前と住所）、関連する入力住所、集計された使用状況データを USPS に報告する必要があります。API を使用すると、お客様はこれらのサービス固有の利用規約に同意したものとみなされます。
次のステップ
- よくある質問を確認する: よくある質問にアクセス
- 対象地域を確認する: 国と地域の対象範囲の詳細をご覧ください。
- 大量のアドレスを処理する: Address Validation API を使用して大量のアドレスを処理するをご覧ください。
-
Google Maps Platform は、United States Postal Service® の非独占的なライセンシーです。United States Postal Service®、CASS™、CASS Certified™ の各商標は、United States Postal Service® が所有し、許諾を得て使用しています。↩