このドキュメントでは、米国に固有の住所検証について説明します。
- ワークフローで 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.