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

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

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

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

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

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

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

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

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

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

Ценить

Поведение

Описание

N или пусто

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

Адрес не был подтвержден 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
  • Регион : США
  • The dpvConfirmation field returns: S

Это означает, что, хотя адрес 1600 Amphitheatre Parkway является допустимым, суб-офис Suite 101 не является допустимой частью адреса. Рекомендуем вам уточнить эту информацию у пользователя и предоставить ему возможность внести исправления.

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

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

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

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

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

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

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

When the USPS identifies an artificially created address, the errorMessage field of the uspsData property of the response contains an error message describing the issue. For example:

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.
,

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

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

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

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

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

As part of the uspsData response, the dpvConfirmation field returns a single character to let you know if the USPS can deliver to the provided address.

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

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

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

Ценить

Поведение

Описание

N или пусто

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

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