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

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

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

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

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

Проверка точки доставки USPS (DPV)

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

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

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

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

Ценить

Поведение

Описание

N или пусто

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

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

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

Д

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

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

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

С

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

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

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

Да

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

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

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

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

Пример ДПВ Н — исправить адрес

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

  • Введенный адрес : 12 Amphitheatre Parkway, Маунтин-Вью, Калифорния, 94043.
  • Регион : США
  • Поле dpvConfirmation возвращает: N

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

Пример ДПВ Д — исправить адрес

В этом примере используется офис 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, Маунтин-Вью, Калифорния, 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.