このドキュメントでは、米国に固有の住所確認について説明します。
- ワークフローでの USPS データの使用
- USPS 配達ポイントの確認フィールド（dpv）
- セキュリティ メッセージ
ワークフロー内の 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 階）という有効な建物群を追加して、
値が Y の dpvConfirmation。
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 が人為的に作成された住所を特定した場合、errorMessage
レスポンスの uspsData プロパティのフィールドに
問題を説明するエラー メッセージが表示されます。例:
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.