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

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

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

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

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

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

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

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

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

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

Ценить

Поведение

Описание

Н

или пустой

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

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

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

Д

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

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

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

С

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

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

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

Y

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

Адрес был подтвержден 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.