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