このドキュメントでは、米国に固有の住所確認について説明します。
ワークフロー内の USPS データ
米国内の住所を検証する場合、Address Validation API サービスは、 戻り値の uspsData 部分に値を入力することもできます。
このオブジェクトは常にデータが入力されるわけではないため、 プロパティを使用して、アドレスを検証する唯一の手段として使用し、代わりに システムに取り込まれます。
USPS Delivery Point Verification（DPV）
uspsData レスポンスの一部として、dpvConfirmation フィールドは単一の
文字を使って、指定された住所に 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
- 地域: USA
dpvConfirmationフィールドからNが返される。
これは、その建物の番号が存在しないことを示す非常に強力なシグナルです。 。他の問題のある住所と同様に、 ユーザーに修正を求めます
DPV D の例 - アドレスの修正
この例ではニューヨークにある Google のオフィスを使用していますが、 これはアドレスの必須部分であるサブプレミスですこれを確認するには、 デモの住所に棟情報が含まれていない場合。
- 入力した住所: 111 8th Avenue, New York, NY, 10011
- 地域: USA
dpvConfirmationフィールドからDが返される。
これは、入力にその区画が欠落していることを示しています。DPV にアクセスするには
入力の一部として有効な区画を含める必要があります。たとえば
この場合、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
- 地域: USA
dpvConfirmationフィールドからYが返される。
住所は USPS ですべて配送できる。これにより、非常に高度な API から返された住所が良質であると確信でき、その住所を使用して 適用されます。
注: DPV は、Address Validation API がなんらかの措置を講じたかどうかを示すものではありません。 入力に対する変更（スペル修正など）が含まれます。
米国の住所向けのセキュリティ メッセージ
このセクションでは、 使用しないでください。このセキュリティ対策は、 送信されたアドレスが送信されたタイミングを検出して、アドレスリストを人為的に は人工的に構築されたもので、合法的に入手されたものではないと思われます。 このエラーが発生するのはごくまれです。
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.