Обработка адресов в США

В этом документе рассматривается проверка адресов, специфичная для Соединенных Штатов:

Использование данных USPS в вашем рабочем процессе

При проверке адресов в Соединенных Штатах API проверки адресов также может заполнять раздел uspsData в полученном ответе.

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

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

В ответе uspsData поле dpvConfirmation возвращает один символ, указывающий на возможность доставки по указанному адресу почтовой службой США (USPS).

С помощью этого поля можно определить следующее:

  • Действительность адреса.
  • если в адресе отсутствует номер подобъекта.
  • если номер филиала отсутствует в системе данных USPS.

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

Ценить

Поведение

Описание

Н

или пустой

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

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

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

Д

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

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

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

С

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

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

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

Я

Примите адрес

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

Это означает, что адрес полностью доступен для доставки почтовой службой USPS, включая номер дополнительного адреса, если таковой имеется.

В оставшейся части этого раздела рассматриваются реальные сценарии использования кодов 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 существует и позволяет принимать почту, прилегающее к нему помещение Ste 101 не является допустимой частью адреса. Ваша система должна подтвердить эту информацию с пользователем и предоставить возможность внести исправление.

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

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

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

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

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

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

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

Когда Почтовая служба США (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.