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

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

Пример: accept

В этом сценарии показан адрес, который ваша система примет от клиента.

Указанный адрес Регион
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 США

Данные Почтовой службы США для неподтвержденного номера дома

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