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

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

Данные 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

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

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

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

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

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

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

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

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

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

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

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

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

Если Почтовая служба США обнаруживает искусственно созданный адрес, поле 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.