Как обрабатывать адреса в США

В этом документе рассматривается проверка адресов в США:

Данные USPS в вашем рабочем процессе

При проверке адресов в США Address Validation API также может заполнять раздел uspsData в ответе.

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

Проверка пунктов доставки USPS (DPV)

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

Это поле позволяет определить следующее:

  • адреса.
  • если в адресе отсутствует номер помещения.
  • если номер дополнительного помещения отсутствует в системе данных USPS.

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

Значение

Алгоритм работы

Описание

НЕТ

или пустое значение

Исправьте адрес

Адрес не подтвержден DPV.

Это означает, что Почтовая служба США не распознает указанный номер помещения на указанной улице (маршруте) и не может доставить туда посылку.

Д

Исправьте адрес

Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере отсутствовала.

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

С

Подтвердите адрес

Адрес был подтвержден DPV только для основного номера, а информация о дополнительном номере присутствовала, но не была подтверждена.

Это означает, что номер здания существует на указанном маршруте, но дополнительный номер в этом здании отсутствует, согласно данным Почтовой службы США.

Да

Принять адрес

Адрес был подтвержден DPV для основного и всех дополнительных номеров.

Это означает, что адрес полностью соответствует требованиям Почтовой службы США, включая номер квартиры или офиса, если применимо.

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

Пример DPV N – исправьте адрес

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

  • Введенный адрес: 12 Amphitheatre Parkway, Mountain View, CA, 94043.
  • Регион: США.
  • Поле dpvConfirmation возвращает: N

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

Пример DPV D – исправьте адрес

В этом примере используется адрес офиса Google в Нью-Йорке, но в нем не указан номер помещения, который является обязательной частью адреса. Вы можете убедиться в этом, используя адрес из демоверсии без информации о субадресе.

  • Введенный адрес: 111 8th Avenue, New York, NY, 10011.
  • Регион: США.
  • Поле dpvConfirmation возвращает: D

Это подтверждает, что в исходных данных не было номера квартиры или офиса. Чтобы получить значение Y, необходимо указать действительный номер помещения. Например, вы можете указать действительный номер помещения FL 4 (4-й этаж), чтобы получить значение dpvConfirmation, равное Y.

Пример DPV S – подтвердите адрес

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

  • Введенный адрес: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043.
  • Регион: США.
  • Поле dpvConfirmation возвращает: S

Это означает, что адрес 1600 Amphitheatre Parkway существует и на него можно отправлять почту, но дополнительный адрес Ste 101 не является действительной частью адреса. Ваша система должна подтвердить эту информацию у пользователя и предоставить возможность ее исправить.

Пример DPV Y – принять адрес

В этом примере в качестве известного качественного адреса используется адрес Googleplex в Маунтин-Вью, Калифорния.

  • Введенный адрес: 1600 Amphitheatre Parkway, Mountain View, CA, 94043.
  • Регион: США.
  • Поле dpvConfirmation возвращает: Y

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

Примечание. DPV не указывает, внес ли Address Validation API какие-либо изменения во входные данные, например исправление орфографии.

Сообщения о безопасности для адресов в США

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

Если Почтовая служба США обнаруживает искусственно созданный адрес, поле errorMessage свойства uspsData в ответе содержит сообщение об ошибке с описанием проблемы. Пример:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.