このドキュメントでは、米国に固有の住所の検証について説明します。
ワークフローでの USPS データ
米国の住所を検証する場合、Address Validation API は戻り値の uspsData 部分にも値を設定できます。
このオブジェクトは常に設定されるとは限らないため、このプロパティをアドレスの検証の唯一の手段として使用するのではなく、判定とアドレス コンポーネントもシステムに組み込む必要があります。
USPS Delivery Point Verification（DPV）
uspsData レスポンスの一部として、dpvConfirmation フィールドは、USPS が指定された住所に配達できるかどうかを示す 1 文字を返します。
このフィールドを使用して、次のことを判断できます。
- 住所の有効性。
- 住所に建物番号が入力されていない場合。
- サブプレミス番号が 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
- 地域: 米国
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.