住所を承認 - 例

このドキュメントでは、Address Validation API がシステムからの受け入れ動作を保証するレスポンス シグナルを提供する実際のシナリオについて説明します。詳しくは、検証レスポンスを使用するのワークフローの概要をご覧ください。

一般的な例: 受け入れ

このシナリオでは、顧客が入力した住所がシステムで受け入れられる住所を示しています。

住所が入力されました 諸国
ロンドン SW1W 9TQ バッキンガム・パレス・ロード 76 英国

住所が許可されるかどうかの判定

以下の例では、重要なシグナルを強調しています。

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

加えて、レスポンスには次の内容が示されます。

  • hasUnconfirmedComponents は false のままです。
  • hasInferredComponents は false のままです。
  • hasReplacedComponents は false のままです。

これらが組み合わさることで、高品質の住所であることがわかります。

エッジケースの例: 受け入れ

次の例は、さらなる調査を必要とするアドレス品質の問題を verdict が示している状況を示しています。また、これらの例は、システム ロジックを強化するために、ロジックが判定結果から住所コンポーネントに移動して、より完全な全体像を得る方法も示しています。

米国以外の未確認の番地

この例は、すべての住所要素が含まれ、推測または置換される要素がないイタリアの住所の入力を示しています。ただし、validationGranularity は ROUTE です。

住所が入力されました 諸国
Via Fonte Grubnale, 14 unit 2, 66054 ヴァスト CH, イタリア IT

未確認の番地に関する判定

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

住所コンポーネントをさらに調査すると、番地が UNCONFIRMED_BUT_PLAUSIBLE であることがわかりました。

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

米国の未確認の番地

この例では、米国の住所の入力時にすべての住所要素が存在し、推定される要素も置換される要素もないことを示しています。ただし、validationGranularity は PREMISE_PROXIMITY です。

住所が入力されました 諸国
〒 101-0054 東京都千代田区神田錦町 3-22 米国

未確認の番地の USPS データ

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

確認済みの住所の USPS データが不完全である

次の例は、すべての住所コンポーネントが確認された米国の住所で、推定されるコンポーネントも置き換えられたコンポーネントもなく、validationGranularity が PREMISE であることを示しています。ただし、uspsData は完全に入力されておらず、dpvConfirmation の値は含まれません。

住所が入力されました 諸国
155 Via Condado Way, パーム ビーチ ガーデンズ, FL 米国

確認された住所の USPS データが不完全であるという判定

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

確認済みの住所の USPS データで USPS データが不完全である

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}