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

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

Распространенный пример: принять

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

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

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

Приведенный ниже пример иллюстрирует важные сигналы.

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

Кроме того, в verdict указано следующее:

  • hasUnconfirmedComponents remains 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 Carson Dr, Sunnyvale, CA 94086 НАС

Данные почтовой службы США по неподтвержденному номеру дома. 

{
   "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",
}

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

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

Введенный адрес Область
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 НАС

Вердикт по подтвержденному адресу с неполными данными почтовой службы США 

{
  "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"
}