Исправить адрес – примеры

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

Распространенные примеры: исправить

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

Отсутствует город и почтовый индекс

В этом примере показана запись, содержащая только почтовый адрес, без города или почтового индекса.

Вердикт по отсутствующему городу и почтовому индексу

В примере ниже подчеркиваются важные сигналы ответа.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "FIX"
}

Действие possibleNextAction даёт первоначальное указание на то, что адрес может быть недоступен для доставки. Другие выделенные компоненты также поддерживают эту возможность, поэтому вы можете запросить addressComponents , чтобы узнать больше:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

API проверки адреса возвращает только страну (США) как CONFIRMED . Все остальные компоненты адреса возвращаются как UNCONFIRMED_BUT_PLAUSIBLE , с некоторыми важными пропусками данных, такими как местоположение и почтовый индекс.

Отсутствует номер улицы

В этом примере показан отсутствующий номер дома.

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

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE",
    "possibleNextAction": "FIX"
}

И снова, possibleNextAction даёт первоначальное указание на то, что адрес, возможно, не может быть доставлен. Более того, значение validationGranularity равно ROUTE , что указывает на соответствие улице, но недостаточно информации для достижения объекта. Кроме того, свойство addressComplete отсутствует в вердикте, поэтому оно равно false . Дальнейший запрос к объекту address обнаруживает отсутствующий тип компонента:

"missingComponentTypes": [
        "street_number"
      ]

Примеры пограничных случаев: исправление

В некоторых ситуациях решение о том, исправить, подтвердить или принять адрес, зависит от конкретного бизнес-сценария. Приведённые ниже примеры иллюстрируют ситуации, которые могут не полностью подпадать под категорию исправления.

Неподтвержденный номер дома

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

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

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

Стоит рассмотреть сочетание детализации валидации только до уровня аппроксимации на уровне предпосылок с неподтверждёнными компонентами. Запрос к свойству addressComponents показывает следующий неподтверждённый componentType :

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Здесь значение confirmation_level для street_number равно UNCONFIRMED_BUT_PLAUSIBLE . Значение Unfirmed означает, что сервис не может сопоставить номер улицы 84 со своим набором данных, а значение plausible означает, что данные компонента всё ещё могут быть действительными.

Отсутствует подпредпосылка

В этом сценарии описывается адрес, в котором отсутствует только один элемент, например, номер квартиры или отдела. В противном случае API проверки адреса может полностью проверить адрес. Как и в случае отсутствия любого компонента адреса, addressComplete имеет значение false и, следовательно, не отображается при ручной проверке вердикта.

Для иллюстрации предположим, что клиент вводит действительный адрес офиса оценщика города Сан-Франциско, но пропускает номер комнаты во входных данных.

Вердикт об отсутствии подпосылки

В этом примере вердикт не отображает свойство addressComplete , поэтому он имеет false . Это означает, что по крайней мере один элемент address непредвиденный, неразрешённый или отсутствует.

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

Запрос address показывает следующее:

"missingComponentTypes": [
        "subpremise"
      ]

При дальнейшем запросе данные USPS предоставили код dpvConfirmation D , который также указывает на отсутствующую подпосылку.