接受地址 - 示例

本文档介绍了一些实际应用场景，在这些场景中，地址验证 API 提供的响应信号可确保您的系统采取接受行为。如需了解相关背景信息，请参阅构建验证逻辑中的工作流示例。

常见示例：接受

此场景展示了您的系统会接受客户输入的地址。

输入的地址 区域
76 Buckingham Palace Road, London SW1W 9TQ 英国

可接受地址的判决

以下示例突出显示了重要信号。

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

此外，响应还表明了以下内容：

  • hasUnconfirmedComponents 仍然为 false
  • hasInferredComponents 仍然为 false
  • hasReplacedComponents 仍然为 false
  • hasSpellCorrectedComponents 仍然为 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"
}