住所を承認 - 例

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

一般的な例: 受け入れ

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

入力された住所 リージョン
76 Buckingham Palace Road, London SW1W 9TQ 英国

受け入れ可能な住所の判定

次の例では、重要なシグナルをハイライト表示しています。

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

これに加えて、verdict は次のことを示します。

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

これらのシグナルを組み合わせると、高品質の住所を示します。

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

次の例では、 verdict が住所の品質に関する問題を指摘し、さらなる調査が必要となる状況について説明します。また、これらの例では、判定から住所の構成要素に移動してより完全な情報を取得し、システム ロジックを強化する方法も示しています。

米国以外の未確認の番地

この例では、すべての住所の構成要素が存在し、推測された構成要素や置き換えられた構成要素がないイタリアの住所の入力を示しています。ただし、 validationGranularity は ROUTE です。

入力された住所 リージョン
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia 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 です。

入力された住所 リージョン
975 Carson Dr, Sunnyvale, CA 94086 米国

未確認の番地の 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, Palm Beach Gardens, FL 33418-1703 米国

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"
}