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