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

В этом документе описан ряд реальных сценариев, в которых 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
}