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

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

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

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

Вердикт о приемлемом адресе

В приведенном ниже примере выделены важные сигналы.

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

В дополнение к этому в ответе указано следующее:

• hasUnconfirmedComponents остается false
• hasInferredComponents остается false
• hasReplacedComponents остается false
• hasSpellCorrectedComponents остается false

В совокупности эти сигналы указывают на высококачественный адрес.

Примеры крайних случаев: принять

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

Неподтвержденный номер дома за пределами США

В этом примере показан ввод итальянского адреса со всеми присутствующими компонентами адреса, без каких-либо выведенных или замененных компонентов. Однако значение validationGranularity равно ROUTE .

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

{
  "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 .

Данные 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 .

Вердикт по подтвержденному адресу с неполными данными 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"
}