米国の住所を処理する

このドキュメントでは、米国に固有の住所の検証について説明します。

ワークフローの USPS データ

米国の住所を検証する場合、Address Validation API サービスは戻り値の uspsData 部分にデータを入力することもできます。

このオブジェクトは常に入力されているわけではないため、アドレスの検証にこのプロパティのみに依存せず、判定結果とアドレス コンポーネントもシステムに組み込む必要があります。

USPS 配達ポイントの確認（DPV）

uspsData レスポンスの一部として、dpvConfirmation フィールドは 1 文字を返します。これは、指定された住所に USPS が配達できるかどうかを示します。

このフィールドを使用すると、次のことがわかります。

  • 住所の有効性を確認します。
  • 住所に建物内の部屋番号が入力されていない場合。
  • 建物の棟番号が USPS データシステムに存在しない場合。

サービスは、4 つの dpvConfirmation 値のいずれかを返すか、dpvConfirmation 値をまったく返しません。次の表に、考えられる 5 つの結果ごとに、ロジックで使用すべき推奨される動作を示します。このロジックの詳細については、検証レスポンスを使用するのワークフローの概要をご覧ください。

値

動作

説明

N または空

住所を修正

住所が DPV で確認されていません。

つまり、USPS は入力された通り（経路）にある入力された建物番号を認識できないため、そこに配送できないということです。

D

住所を修正する

住所はプライマリ番号についてのみ DPV が確認されており、セカンダリ番号の情報がありませんでした。

これは、入力された建物番号が入力された通りに存在することを意味します。ただし、完全に確認済み/配達可能な住所になるには、有効な副建物番号も指定する必要があります。つまり、入力にサブ前提が含まれていませんでした。

S

住所の確認

アドレスはプライマリ番号に対してのみ DPV で確認され、セカンダリ番号情報は存在していましたが、確認されていません。

つまり、入力された住所番号は入力されたルート上に存在しますが、USPS によると、指定されたサブプレミスはその建物内に存在しません。

Y

住所を承認する

住所は、プライマリ番号とセカンダリ番号の両方で DPV で確認済みです。

つまり、住所が USPS によって完全に配達可能であることを意味します（該当する場合は、サブプレミス番号も含みます）。

このセクションの残りの部分では、DPV コードを使用する実際のシナリオについて説明します。

DPV N の例 - アドレスの修正

この例では、有効な住所の番地が存在しません。

  • 入力された住所: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • 地域: 米国
  • dpvConfirmation フィールドは N を返します。

これは、この住所番号がこのルートに存在しないことを示す非常に強いシグナルです。他の問題のある住所と同様に、システムはユーザーに修正を求めるメッセージを表示する必要があります。

DPV D の例 - 住所を修正する

この例では、ニューヨークの Google オフィスを使用していますが、住所の必須部分であるサブプレミスがありません。これは、サブプレミス情報なしでデモのアドレスを使用すると確認できます。

  • 入力された住所: 111 8th Avenue, New York, NY, 10011
  • 地域: 米国
  • dpvConfirmation フィールドから D が返される。

入力にサブ前提条件が含まれていないことが確認できます。DPV が Y になるようにするには、入力の一部として有効なサブプレミスを含める必要があります。たとえば、有効なサブプレミス FL 4（4 階）を含めて、dpvConfirmation 値を Y に設定できます。

DPV S の例 - 住所を確認する

この例では、建物内に存在しないサブプレミス番号を使用しています。

  • 入力された住所: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • 地域: USA
  • dpvConfirmation フィールドは S を返します。

これは、1600 Amphitheatre Parkway は郵便物を受け取ることができる住所として存在するものの、サブプレミス Ste 101 は住所の有効な部分ではないことを示しています。システムは、この情報をユーザーに確認し、修正の機会を提供する必要があります。

DPV Y の例 - アドレスを受け入れる

この例では、カリフォルニア州マウンテンビューの Googleplex のアドレスを既知の品質アドレスとして使用しています。

  • 入力された住所: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • 地域: 米国
  • dpvConfirmation フィールドは Y を返します。

住所は USPS によって完全に配達可能です。これにより、API が返したアドレスの品質が非常に高いことを確認でき、そのまま使用できます。

注: DPV には、Address Validation API が入力に変更（スペル修正など）を加えたかどうかは示されません。

米国の住所向けのセキュリティ メッセージ

このセクションでは、人為的に作成された住所について、USPS データで提供されるセキュリティ フラグについて説明します。このセキュリティ対策は、送信された住所が不正に作成されたものであり、正当に取得されたものではないと判断された場合に、住所リストが不正に作成されるのを防ぐことを目的としています。このエラーが発生するのはごくまれです。

USPS が人工的に作成された住所を特定すると、レスポンスの uspsData プロパティの errorMessage フィールドに、問題を説明するエラー メッセージが含まれます。例:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.