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

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

Примечание: приведенные здесь примеры носят иллюстративный, но не исчерпывающий характер.

Типичный пример: принять

Этот сценарий иллюстрирует адрес, по которому ваша система будет принимать адрес, введенный клиентом.

Адрес введен	Область
Букингемский дворец, 76, Лондон SW1W 9TQ	Великобритания

Вердикт о приемлемом адресе

В примере ниже выделены важные сигналы.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Помимо этого в ответе указывается следующее:

• hasUnconfirmedComponents остается false
• hasInferredComponents остается false
• hasReplacedComponents остается false

Объединение этих сигналов указывает на высококачественный адрес.

Действие: Принять.

Примеры крайних случаев: принять

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

Примечание: эти примеры не являются исчерпывающими, но репрезентативными.

Неподтвержденный номер улицы за пределами США

В этом примере показан ввод итальянского адреса со всеми присутствующими компонентами адреса, а также без предполагаемых или замененных компонентов. Однако validationGranularity имеет значение ROUTE .

Адрес введен	Область
Via Fonte Grugnale, 14, блок 2, 66054 Васто CH, Италия	ЭТО

Вердикт по неподтверждённому номеру дома

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Дальнейшее исследование компонентов адреса показывает, что номер улицы — UNCONFIRMED_BUT_PLAUSIBLE .

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Действие: Этот адрес можно принять без дополнительных запросов. Однако для более высокого уровня доверия вы можете предложить клиенту подтвердить адрес. Дополнительные сведения см. в руководстве по реализации в разделе Создание логики проверки .

Неподтвержденный номер улицы в США

Этот пример иллюстрирует ввод адреса в США со всеми присутствующими компонентами адреса, без каких-либо предполагаемых или замененных компонентов. Однако validationGranularity равна PREMISE_PROXIMITY .

Адрес введен	Область
975 Карсон Доктор, Саннивейл, Калифорния 94086	НАС

Данные USPS для неподтвержденного номера улицы

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

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

Неполные данные USPS для подтвержденного адреса

В этом примере показан ввод адреса в США со всеми подтвержденными компонентами адреса, без выведенных или замененных компонентов, а также с параметром validationGranularity PREMISE . Однако uspsData заполнен не полностью и не содержит значения dpvConfirmation .

Адрес введен	Область
155 Via Condado Way, Палм-Бич-Гарденс, Флорида 33418-1703	НАС

Вердикт по подтвержденному адресу с неполными данными USPS

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

Данные USPS для подтвержденного адреса с неполными данными USPS

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}

Действие: Принять. Несмотря на то, что адрес не является DPV, подтвержденным USPS, validationGranularity PREMISE дает сильный сигнал о том, что это действительный адрес. Однако для более высокого уровня доверия вы можете предложить клиенту подтвердить адрес. Дополнительные сведения см. в руководстве по реализации в разделе «Создание логики проверки» .

Примечание. Служба периодически получает обновленные данные USPS, поэтому этот пример больше не может возвращать неполные данные USPS. Этот пример предназначен для иллюстрации, а не для точного изображения ответа API для этого адреса.