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

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

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

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

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

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

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

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

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

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

Ценить

Поведение

Описание

N или пусто

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

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

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

Д

Добавить подпомещение

Адрес был подтвержден 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 является допустимым адресом, суб-предприятие Suite 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.