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

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

Пример: добавление помещений

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

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

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

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

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

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

Отсутствующие дополнительные помещения, а также предполагаемые и замененные компоненты

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

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

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