Добавить подпомещения к адресу — примеры (только для США)

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

Типичный пример: добавление подпомещений

В этом сценарии показан адрес, в котором ваша система может предложить клиенту добавить к адресу номер помещения.

Адрес введен Область
1450 Брикелл Авеню, Майами, Флорида 33131-4065 НАС

Вердикт по адресу, в котором отсутствует субпомещение

Приведенный ниже пример подчеркивает важный сигнал.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Пример пограничного случая: добавление подпомещений

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

Отсутствующие подпосылки и выведенные и замененные компоненты

В этом примере показан ввод адреса в США с отсутствующим населенным пунктом и неверным почтовым индексом.

Адрес введен Область
1450 Брикелл Авеню, Флорида 33132-4065 НАС

Вердикт об отсутствующей подпосылке и выведенных и замененных компонентах 

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Дальнейшее изучение компонентов адреса показывает, что местоположение было определено, а почтовый индекс был заменен.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}