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 で使用可能なリソースと、返されるデータを示します。詳細については、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®）¹ は、住所検証サービスのプロバイダを支援し認定するために、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 を使用して大量のアドレスを処理するをご覧ください。