このドキュメントでは、米国に固有の住所確認について説明します。
ワークフロー内の USPS データ
米国の住所を検証する場合、Address Validation API サービスは戻り値の uspsData 部分にデータを入力することもできます。
このオブジェクトは常にデータが入力されるとは限らないため、このプロパティを単独で住所の検証に使用するのではなく、判定結果と住所のコンポーネントもシステムに組み込むようにしてください。
USPS Delivery Point Verification（DPV）
uspsData レスポンスの一部として、dpvConfirmation フィールドは 1 文字を返します。これは、指定された住所に 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
- 地域: USA
dpvConfirmationフィールドからNが返される。
これは、このオンプレミス番号がこのルートに存在しないことを示す非常に強力なシグナルです。他の問題のある住所と同様に、ユーザーに修正を求める必要があります。
DPV D の例 - アドレスの修正
この例では、ニューヨークにある Google オフィスを使用していますが、住所の必須部分であるサブプレミスは含まれていません。デモで建物の棟の情報を指定せずに住所を使用すると確認できます。
- 入力した住所: 111 8th Avenue, New York, NY, 10011
- 地域: USA
dpvConfirmationフィールドからDが返される。
これは、入力にその区画が欠落していることを示しています。DPV を Y にするには、有効なサブプレミスを入力の一部として含める必要があります。たとえば、有効なサブプレミス FL 4（4 階）を含めると、dpvConfirmation の値 Y を取得できます。
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 データで提供されるセキュリティ フラグについて説明します。このセキュリティ対策は、送信された住所が人為的に構築されたもので、正規に取得されていないように見える場合に検出することで、アドレスリストの人為的な作成を防止することを目的としています。このエラーが発生するのはごくまれです。
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.