このドキュメントでは、米国に固有の住所確認について説明します。
ワークフローでの 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 によると、指定された建物の棟内には存在しないことを意味します。 |
○ |
住所を承認 |
プライマリ番号とセカンダリ番号で 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.