Принять адрес — примеры

В этом документе описывается ряд реальных сценариев, в которых API проверки адресов предоставляет сигналы ответа, которые гарантируют принятие поведения вашей системы. См. примеры рабочих процессов в разделе Создание логики проверки для контекста.

Типичный пример: принять

Этот сценарий иллюстрирует адрес, в котором ваша система принимает адрес, введенный клиентом.

Адрес введен Область
76 Букингем Пэлас Роуд, Лондон 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, блок 2, 66054 Васто CH, Италия ЭТО

Вердикт по неподтвержденному номеру улицы 

{
  "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, Саннивейл, Калифорния 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, Палм-Бич-Гарденс, Флорида 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"
}