Выберите решение для проверки адреса

Блок-схема, показывающая общий обзор этапов тестирования.

Цель

Проверка адресов полезна для множества сценариев использования, и помимо качества результатов тестирования, мы рекомендуем вам изучить ряд важных моментов. Например: целостное представление о совместимых продуктах в пользовательском сценарии, таких как автозаполнение мест и карты , региональная доступность, а также доверие и надежность в масштабах предприятия .

Когда вы дойдете до этапа оценки API проверки адресов, вот несколько рекомендаций, которые мы советуем использовать в процессе тестирования.

Цели этого теста будут заключаться в следующем:

  1. API подтверждения адреса подходит для вашего случая.
  2. Проверьте, насколько API проверки адресов соответствует требованиям вашего решения, например:
    • Выявление адресов высокого качества.
    • Система оповещения о некачественных входных данных.
    • Внесение исправлений в данные, включая выводы, замены и исправление орфографических ошибок.
    • Укажите отформатированный адрес для доставки.
    • Оповещение об отсутствующих или некорректных данных о субобъектах (только для США).
  3. Убедитесь, что внедрение API принесет вам измеримую выгоду.

После проведения тестирования вы сможете ответить на вышеуказанные вопросы и определить, подходит ли API для вашего бизнеса.

Подготовьте свои данные

Ваш тест следует проводить на выборке из имеющихся у вас адресных данных. Не выбирайте данные вручную, а используйте случайные выборки, репрезентативные для географических регионов, в которых вы работаете. Это означает, что если вы работаете как в США, так и в Великобритании, но 70% вашего бизнеса приходится на Великобританию, а 30% — на США, выборка должна отражать это соотношение.

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

Для проведения теста подготовьте выборку размером примерно 5000–10000 записей.

Вызовите API

Предварительное условие для прохождения раздела: понимание того, как отправить запрос на проверку адреса .

После подготовки данных вам потребуется проверить каждую запись адреса с помощью API.

Инструкции по вызову API см. в документации по API проверки адресов . У нас также есть статья, описывающая лучшие практики использования API проверки адресов для обработки больших объемов адресов .

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

Просмотрите результаты

Предварительное условие для прохождения раздела: понимание того, как обрабатывать ответы на запросы валидации , особенно концепции исправления, подтверждения и принятия .

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

Обзор ключевых полей API, рассматриваемых в этом документе.

Данные ответа

Что это такое?

Как проводить оценку

Чем это помогает?

verdict.inputGranularity

Описывает уровень детализации входного адреса.

SUB_PREMISE

ПОМЕЩЕНИЕ

БЛИЗОСТЬ ПОМЕЩЕНИЯ

БЛОКИРОВАТЬ

МАРШРУТ

ДРУГОЙ

Позволяет определить, содержит ли входной адрес достаточно данных, чтобы потенциально считаться действительным.

вердикт.проверкаДетализация

Описывает общую проверку выходных данных адреса.

SUB_PREMISE

ПОМЕЩЕНИЕ

БЛИЗОСТЬ ПОМЕЩЕНИЯ

БЛОКИРОВАТЬ

МАРШРУТ

ДРУГОЙ

Позволяет определить общее качество адресации на выходе API.

verdict.hasInferredComponents

Сигнализирует, если API определил компонент автоматически.

Верно/Неверно

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

verdict.hasReplacedComponents

Сигнализирует о том, что API заменил компонент.

Верно/Неверно

В некоторых сценариях API способен заменять некорректные компоненты правильными данными.

verdict.addressComplete

Сигнализирует о том, что адрес является полным.

Верно/Неверно

Если API определит, что выходной адрес содержит все необходимые компоненты, это будет истинным.

address.missingComponentTypes

Сигнал, предупреждающий о наличии недостающих компонентов в адресе.

Значения приведены в таблице два .

Выделить недостающие компоненты в неполном адресе.

Проверьте действительные адреса.

Отсортируйте данные, полученные от API, чтобы определить набор адресов, которые ваша система сочтет действительными. Ключевые сигналы, на которые следует обратить внимание при работе с API:

  • verdict.validationGranularity содержит PREMISE или лучше.
  • verdict.addressComplete is true .
  • Компоненты не были ни предполагаемыми, ни замененными.

Дополнительную информацию см. в разделе «Принять адрес» .

Результатом этого упражнения должна стать выборка адресных данных, которые ваша система сочтет допустимыми. На этом этапе вы можете определить:

  • Допустим ли такой процент одобрения?
  • Если использовать существующий процесс проверки адресов, будет ли процент одобрения эквивалентным или выше?

Пример: Действительный адрес

Введенный адрес

Область

Букингемская дорога, 76, Лондон SW1W 9TQ

Великобритания

Вердикт

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

Проверьте недействительные адреса.

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

Отсортируйте данные, полученные от API, чтобы определить набор адресов, которые ваша система пометит как недействительные. Ключевые сигналы, на которые следует обратить внимание при работе с API:

  • verdict.validationGranularity устанавливается на OTHER или ROUTE в зависимости от вашего уровня риска .
  • verdict.addressComplete имеет значение false .

Дополнительную информацию см. в разделе «Исправление адреса» .

Результатом этого упражнения должна стать выборка адресных данных, которые ваша система пометит как недействительные. На этом этапе вы можете определить, является ли процент недействительных данных приемлемым.

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

Пример: Неверный адрес

Введенный адрес

Область

21 45 40-я улица

США

Вердикт

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Проверьте отсутствующие или неподтвержденные компоненты.

На этом этапе также можно проверить отсутствующие или неподтвержденные компоненты. Это часть объекта Address в возвращаемом результате. Два поля называются missingComponentTypes и unconfirmedComponentTypes .

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

Пример: Отсутствующий и неподтвержденный компонент

Введенный адрес

Область

Фейк-стрит, Нью-Йорк, штат Нью-Йорк, 10011

США

Вердикт

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Отсутствующие и неподтвержденные компоненты

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Проверьте адреса и внесите исправления.

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

Ключевые сигналы, на которые следует обратить внимание:

  • inferred , replaced или spellCorrected установлен в true для любого из addressComponents .
  • Установите значение true для параметра verdict.hasInferredComponents или verdict.hasReplacedComponents .

Для получения более подробной информации см. раздел «Подтверждение адреса» .

Результатом этого упражнения должна стать выборка из подмножества адресных данных, в которые API внес исправления.

Часть этих данных можно проверить вручную, чтобы определить, вносит ли API корректировки в ваши данные, которые могли бы уменьшить сложности в дальнейшем рабочем процессе.

Пример: Адрес с поправкой

Введенный адрес

Область

76 Brucking Palace Road, Лондон SW1W 9TQ

Великобритания

addressComponent маршрута

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Только для США] Проверьте адрес с отсутствующими или неверными данными о субподрядных помещениях.

API проверки адресов позволяет определить, отсутствует ли или указана ли некорректная информация о дочернем предприятии для адресов в США.

Ключевые сигналы, на которые следует обратить внимание:

  • В объекте Address :
    • unconfirmedComponentTypes содержит subpremise
    • missingComponentTypes содержит subpremise
  • В объекте UspsData :
    • dpvConfirmation is D (subpremise missing)
    • dpvConfirmation is S (subpremise unconfirmed)

Для получения дополнительной информации см. адреса в США .

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

Пример: Отсутствует подпосылка

Введенный адрес

Область

111 8-я Авеню, Манхэттен, Нью-Йорк 10011

НАС

Отсутствующий компонент

"missingComponentTypes": [
    "subpremise"
]

Подтверждение данных USPS DPV

"dpvConfirmation": "D"

[Только для США] Ознакомьтесь со стандартизированным адресом USPS.

API проверки адресов также возвращает стандартизированный адрес USPS для адресов в Соединенных Штатах. Это особенно важно, если вам необходимо печатать адреса в формате USPS на ваших транспортных этикетках.

Для просмотра этих данных и определения того, приносят ли они пользу вашему рабочему процессу, можно просмотреть информацию в файле UspsAddress .

Пример: стандартизированный адрес USPS. 

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Заключение

Начните тестирование — начните тестирование API проверки адресов уже сегодня, чтобы обеспечить точность адресных данных, улучшить взаимодействие с клиентами и оптимизировать бизнес-процессы. После выполнения описанных выше тестовых сценариев у вас будет вся необходимая информация, чтобы определить, принесет ли API проверки адресов пользу вашему рабочему процессу.

Рекомендуемая дополнительная литература:

Авторы

Хенрик Вэлв | Инженер DevX