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