Руководство по решению для проверки адресов

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

Цель

Address Validation API полезен в самых разных ситуациях. Помимо качества результатов тестирования, рекомендуем обратить внимание на следующие аспекты: Например, вы можете получить общее представление о совместимых продуктах в пути пользователя, таких как автозаполнение мест и Карты, доступность в регионах, а также доверие и надежность для предприятий.

Когда вы будете готовы оценить Address Validation API, рекомендуем использовать следующие рекомендации в рамках тестирования.

Цели этого тестирования:

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

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

Подготовка данных

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

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

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

Вызов API

Предварительное условие: узнайте, как отправить запрос на проверку адреса.

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

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

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

Как посмотреть результаты

Предварительные требования. Узнайте, как обрабатывать ответ проверки, особенно концепцию "Исправить, подтвердить и принять".

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

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

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

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

Как оценить

Зачем это нужно

verdict.inputGranularity

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

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

ЗАБЛОКИРОВАТЬ

ROUTE

ДРУГОЕ

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

verdict.validationGranularity

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

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

ЗАБЛОКИРОВАТЬ

ROUTE

ДРУГОЕ

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

verdict.hasInferredComponents

Указывает, определил ли API компонент.

Истина/ложь;

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

verdict.hasReplacedComponents

Указывает, заменил ли API компонент.

Истина/ложь;

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

verdict.addressComplete

Указывает, является ли адрес полным.

Истина/ложь;

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

address.missingComponentTypes

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

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

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

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

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

  • verdict.validationGranularity содержит PREMISE или лучше.
  • verdict.addressComplete: true.
  • Нет предполагаемых или замененных компонентов.

Подробнее о том, как принять адрес…

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

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

Пример действительного адреса

Адрес введен

Регион

76 Buckingham Palace Road, London SW1W 9TQ

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

Verdict

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

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

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

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

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

Подробнее о том, как исправить адрес…

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

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

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

Адрес введен

Регион

21 45 40th street

США

Verdict

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

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

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

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

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

Указанный адрес

Регион

Fake St, New York, NY 10011

США

Verdict

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

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

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

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

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

Вот на что нужно обратить внимание:

  • inferred, replaced или spellCorrected со значением true на любом из addressComponents.
  • verdict.hasInferredComponents или verdict.hasReplacedComponents со значением true.

Подробнее о том, как подтвердить адрес…

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

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

Пример адреса с исправлением

Адрес введен

Регион

76 Bruckingm Palace Road, London SW1W 9TQ

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

Маршрут addressComponent

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

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

Address Validation API может определить, отсутствует ли номер квартиры или офиса в адресе США или указан неправильно.

Вот на что нужно обратить внимание:

  • В объекте Address:
    • unconfirmedComponentTypes содержит subpremise
    • missingComponentTypes содержит subpremise
  • В объекте UspsData:
    • dpvConfirmation – D (не указан номер помещения)
    • dpvConfirmation – S (номер помещения не подтвержден)

Подробнее о том, как работать с адресами в США…

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

Пример: отсутствует номер помещения

Адрес введен

Регион

111 8th Avenue, Manhattan, NY 10011

США

Отсутствует компонент

"missingComponentTypes": [
    "subpremise"
]

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

"dpvConfirmation": "D"

[Только для США] Проверьте standardizedAddress в USPS

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

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

Пример: стандартизированный адрес Почтовой службы США

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

Заключение

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

Дополнительные сведения

Авторы

Хенрик Вальве (Henrik Valve) | инженер DevX