Address Validation API の概要

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Address Validation API は、住所を受け入れて住所コンポーネントを識別し、検証するサービスです。また、郵送先住所を標準化して、緯度および経度の最適な位置を見つけることもできます。住所が実在の場所かどうかを区別するのに役立ちます。住所が実際の場所を参照していない場合は、正しくないコンポーネントを特定し、ユーザーが修正できるようにします。

Address Validation API には、住所の処理に役立つ次のような多くの機能が用意されています。

  • 住所を個々のコンポーネントに分割し、区画データ(利用可能な場合)を含むコンポーネント レベルの検証チェックを行います。

  • 住所の欠落や正しくない住所のクレンジング、標準化、推測

  • 住所、ジオコード、住所の精度、郵便サービスのデータなど、住所を補足します。

  • API が決定した完全なアドレスを含む単一の文字列を返します。

デモを試して、Address Validation API の動作を確認しましょう。

ワークフローに Address Validation API を追加する

Address Validation API の最も一般的なユースケースの 1 つは、ユーザーが正しい住所を提供することで、カスタマー エクスペリエンスを向上させることです。住所検証は、不正な住所をキャッチして配達ミスを削減し、住所の特性を認識して配達の予測可能性を向上させるのに役立ちます。

次の図は、購入手続きで住所の入力を可能にする簡単なフォームを示しています。このアドレスを入力として Address Validation API に渡します。

顧客が入力した住所。

レスポンスでは、Address Validation API は API が決定した完全なアドレスを返します。完全な住所を推奨住所としてお客様に提示してください。

API が決定するアドレス。

Address Validation API が不足している情報を検出した場合、その情報を追加するようユーザーに求めます。

お客様に住所情報の入力を求めるフォーム

情報が不足しているか誤っているために API で入力住所を検証できない場合は、住所を修正するようユーザーに促します。

お客様に住所情報の修正を求めるフォーム

Address Validation API と Geocoding API の違い

Geocoding API と Address Validation API はどちらも、「このユーザー入力に最適な場所は?」といった問いに答えようとします。Geocoding API とは異なり、Address Validation API は以下も試みます。

  • 「このユーザー入力は実際の住所を表しているか」という質問に答えてください。
  • 入力データの一部が利用可能なデータと一致しない場合でも入力アドレスを理解する
  • さまざまなコンポーネントの有効性に関するフィードバックを提供
  • アドレスが完全に入力されているかどうかを確認し、欠落している必要なコンポーネントがあれば報告します。
  • 返送された住所を郵送のみに適した形式にする

たとえば、「123 Fake St, Mountain View, CA」のような住所を指定した場合、Geocoding API は、カリフォルニア州マウンテン ビュー市のジオコードを返し、マウンテン ビューにはそのような名前(またはそれに類似した名前の通り)がないため、「123 Fake St」を無視します。

一方、Address Validation API は、「123」が番地であり、「Fake St」が道路であることを識別し、それらのコンポーネントを含む未確認のフラグを返します。これにより、住所がジオコーディングできない理由を示すシグナルが提供されます。

CASSTM について

United States Post Service®(USPS®)1は、Coding Accuracy Support System(CASSTM)を管理して住所確認プロバイダをサポートし、認定しています。Address Validation API などの CASS CertifiedTM サービスは、住所の欠落している情報を埋め、標準化し、最新かつ最も正確な住所を提供するために更新できることを確認しています。

CASS はデフォルトで有効ではなく、「US」と「PR」のリージョンでのみサポートされます。CASS を有効にするには、検証リクエストの一部として enableUspsCasstrue に設定します。詳細については、住所の検証をご覧ください。

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

次のステップ


  1. Google Maps Platform は、米国の郵便サービス® の非独占的なライセンシーです。次の商標は、米国郵便サービス®が所有し、許可を得て使用しています。米国郵便サービス®、CASSTM、CASS 認定 TM です。