Сервисы расчёта расстояния и ключи

Эта часть о ключах: обязательном ключе DaData и необязательных ключах сервисов карт, которые считают расстояние по дорогам. Здесь же — что значит каждый ответ кнопки «Проверить», как работает лимит запросов и что делает плагин, когда сервис не отвечает. С чего начать, рассказано в главной статье.

Ключ DaData — нужен всегда #

DaData — российский сервис подсказок адресов. Плагин использует его для четырёх вещей:

• подсказки адреса покупателю на оформлении заказа;
• подсказки адреса склада;
• поиск адреса покупателя на карте — без координат адреса расстояние не посчитать;
• подсказки населённых пунктов в режиме «Доставка в городе».

Поэтому ключ DaData нужен, даже если расстояние считается по прямой.

Как получить ключ DaData #

1. Откройте сайт DaData и нажмите «Зарегистрироваться».
2. Подтвердите почту по ссылке из письма. Пока почта не подтверждена, ключ не работает.
3. Войдите в личный кабинет DaData и скопируйте API-ключ.

После регистрации сразу включается бесплатный тариф. Секретный ключ этому плагину не нужен.

Куда вставить ключ #

1. Откройте «Woodev → Настройки», вкладку «Доставка», раздел «Локация».
2. Вставьте ключ в поле «Токен API DaData».
3. Нажмите «Сохранить».

Это поле общее для всех плагинов доставки Woodev на сайте. Если ключ уже указан, например, для СДЭК, второй раз вводить его не нужно. Поле «Секретный ключ DaData (Clean API)» рядом можно оставить пустым.

Сколько запросов даёт бесплатный тариф #

На бесплатном тарифе DaData разрешает 10 000 запросов в день на все подсказки вместе. Каждая подсказка, пока покупатель набирает адрес, — это запрос. Когда дневной лимит исчерпан, подсказки не работают до начала следующего дня.

Сам плагин тратит запросы бережно: адрес, который уже искали, он помнит и не ищет снова, а на поиск адресов покупателей на карте тратит не больше 5 000 запросов в сутки. Если магазину не хватает бесплатного лимита, тариф можно повысить в кабинете DaData.

В каких странах работают подсказки #

• Россия, Беларусь, Казахстан, Узбекистан — подсказки до номера дома, расстояние считается точно.
• Армения, Азербайджан, Киргизия, Таджикистан, Туркменистан — доступны подсказки населённых пунктов, но расчёт доставки этим плагином по полному адресу не поддерживается: после ввода улицы способ может исчезнуть. Для таких адресов используйте другой способ доставки.

Что будет без ключа DaData #

Без ключа DaData не работают новые подсказки и поиск полного адреса. Для уже известного населённого пункта, например из сохранённого списка «Доставка в городе», ещё может показываться примерная цена; для полноценного оформления верните ключ. Если включено «Логирование», в журнале будет причина «Не указан ключ DaData». Если DaData не отвечает или не принимает ключ, причина будет «DaData временно недоступна».

Подвкладка «Сервисы» #

Откройте «Woodev → Настройки», вкладку «Расчёт за расстояние», подвкладку «Сервисы». Над таблицей написано: «„По прямой“ работает всегда и бесплатно; чтобы считать по дорогам, подключите сервис ключом API.»

В таблице по строке на каждый способ расчёта: «По прямой», OpenRouteService, Mapbox, 2ГИС, Яндекс и Google. Колонки:

• «Статус» — «● Работает» у расчёта по прямой; у сервисов «○ Не подключён», «● Подключён» или «✖ Ошибка».
• «Ключ API» — поле для ключа. Подсказка у заголовка: «Ключ доступа выдаёт сам сервис в кабинете разработчика; у OpenRouteService он бесплатный (2 000 запросов в сутки). Вставьте его и нажмите «Проверить».»
• «Лимит в сутки» — сколько раз за сутки плагин может обратиться к сервису. У строки «По прямой» здесь вместо лимита стоит коэффициент дороги.
• Кнопка «Проверить».

В строке каждого сервиса есть ссылка «Получить ключ …» — она открывает страницу сервиса, где выдают ключ, в новой вкладке.

Расчёт по прямой и коэффициент дороги #

«По прямой» — это длина воображаемой линии между складом и адресом. Такой расчёт работает всегда, бесплатно и без ключа сервиса карт. Но дорога всегда длиннее прямой линии, поэтому есть коэффициент дороги — поле «коэф.» в строке «По прямой».

Расстояние по прямой умножается на это число. В новых магазинах стоит 1,3: прямые 10 км считаются как 13 км. Можно указать от 1 до 3 с шагом 0,1. Подсказка у поля: «Дорога длиннее прямой: обычно в 1,2–1,4 раза, в большом городе с рекой и развязками — больше. Расстояние по прямой умножается на это число (от 1 до 3). Точнее всего — подключить сервис карт.»

Тот же коэффициент применяется, когда сервис карт не ответил и плагин считает по прямой вместо него.

По прямой не считается время в пути. Поэтому «Время в пути» в названии способа видно только при расчёте через сервис.

Как подключить сервис карт #

1. Получите ключ у сервиса — как это сделать у каждого, рассказано ниже.
2. Вставьте ключ в поле «Ключ API» в строке сервиса.
3. Нажмите «Проверить». Кнопка проверяет ключ, который сейчас в поле, даже если вы его ещё не сохранили.
4. Нажмите «Сохранить» под таблицей. Пока вы не сохранили, ключ не записан.
5. Откройте способ доставки и выберите этот сервис в поле «Расчёт расстояния». Склад и сервис выбираются в каждом способе отдельно, так что можно подключить сервис и пока ни в одном способе им не пользоваться.

Сохранённый ключ в поле скрыт. Его можно заменить новым или очистить. Когда вы меняете или удаляете ключ, плагин забывает расстояния, посчитанные со старым ключом.

Что отвечает кнопка «Проверить» #

Плагин делает один настоящий запрос: строит пробный маршрут по Москве — от Красной площади до Цветного бульвара. Результат появляется под строкой.

• «Подключение работает: 5,7 км» — всё в порядке, сервис построил маршрут. Число зависит от сервиса: проверка всегда строит пробный маршрут на машине, без исключения дорог.
• «Укажите ключ API.» — поле пустое.
• «Ключ не принят сервисом. Проверьте ключ.» — ключ неверный, с лишними пробелами, ещё не активирован или у него нет доступа к нужной функции сервиса.
• «Превышен лимит запросов. Попробуйте позже.» — у сервиса закончились запросы по вашему тарифу.
• «Сервис не ответил. Попробуйте позже.» — нет связи с сервисом или он временно не работает.
• «Сервис ответил, но расстояние выглядит неверным. Проверьте ключ и настройки сервиса.» — ответ пришёл, но пробный маршрут получился короче 1 км или длиннее 15 км.
• «Достигнут лимит запросов в сутки (проверка тоже считается запросом). Повторите завтра или увеличьте лимит.» — исчерпан ваш собственный «Лимит в сутки» этого сервиса.

Проверка — тоже запрос: она тратит одну единицу лимита у сервиса и в вашем «Лимите в сутки». Удачная проверка сохранённого ключа снимает красный статус «✖ Ошибка» и уведомление об ошибке.

Лимит в сутки #

Подсказка у заголовка колонки: «Сколько раз за сутки плагин может обратиться к сервису. Когда лимит исчерпан, до конца суток расстояние считается по прямой; пусто — без ограничения.»

• В новых магазинах у OpenRouteService стоит 1 900 — чуть меньше его бесплатных 2 000 запросов в сутки. У Яндекса — 1 000, как на его минимальном тарифе. У остальных поле пустое, то есть без ограничения.
• Пустое поле — без ограничения. 0 — новые запросы к сервису не отправляются, но уже сохранённые маршруты продолжают использоваться, пока не истечёт срок их хранения.
• Сутки плагин считает по всемирному времени: счётчик обнуляется в 03:00 по Москве.
• Запросы тратятся не на каждого покупателя. Плагин помнит уже посчитанные маршруты: у OpenRouteService, 2ГИС и Яндекса — до 7 дней, у Mapbox и Google — до суток, с учётом пробок — не дольше часа. При нескольких складах запрос уходит только от одного склада.

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

Где получить ключ каждого сервиса #

Сервис	Стоимость	Карта для регистрации	Кому подходит
OpenRouteService	бесплатно, 2 000 маршрутов в сутки	не нужна	большинству магазинов
Mapbox	бесплатно 10 000 маршрутов в месяц без карты, больше — платно	не нужна	маленьким магазинам и для пробы
2ГИС	платно, пакеты в рублях; бесплатный демо-ключ на месяц	не нужна для демо	тем, кому нужны российские карты и пробки
Яндекс	только платно, тарифы в рублях	—	тем, кто уже работает с Яндексом
Google	бесплатная квота в месяц, дальше платно	нужна зарубежная карта	тем, у кого есть платёжный аккаунт Google

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

OpenRouteService (бесплатно) #

OpenRouteService — сервис маршрутов на открытых картах OpenStreetMap. Его разрабатывает немецкий институт HeiGIT. Бесплатного тарифа хватает большинству магазинов.

1. Откройте страницу регистрации HeiGIT и заведите аккаунт.
2. Подтвердите почту, если сервис об этом попросит, и войдите в кабинет HeiGIT.
3. Скопируйте ключ API в кабинете. Новые ключи длинные и начинаются с «eyJ» — копируйте целиком.
4. Вставьте ключ в строку «OpenRouteService» и нажмите «Проверить», а потом «Сохранить».

Бесплатно сервис строит 2 000 маршрутов в сутки и до 40 в минуту. Банковская карта не нужна. По правилам сервиса ключ личный: не публикуйте его. Плагин обращается к сервису только со своего сервера, ключ в браузер покупателя не попадает.

Способы передвижения: на машине, пешком, на велосипеде. Учёта пробок у OpenRouteService нет.

Mapbox #

1. Откройте регистрацию Mapbox, заполните форму и выберите «Start without a credit card» — начать без банковской карты.
2. Подтвердите почту по ссылке из письма. Ссылка действует 24 часа.
3. Откройте страницу Access tokens и скопируйте ключ по умолчанию — он начинается с «pk.».
4. Вставьте его в строку «Mapbox», нажмите «Проверить» и «Сохранить».

Без банковской карты Mapbox даёт пробный период с 10 000 маршрутов в месяц и одним ключом. Создавать новые ключи можно только после того, как вы добавите способ оплаты, но для плагина хватает ключа по умолчанию. Если выбрать «Без карты», после исчерпания лимита сервис просто перестаёт отвечать и ничего не списывает — плагин тогда считает по прямой. С привязанной картой бесплатны 100 000 маршрутов в месяц, дальше — по тарифам на странице цен Mapbox.

Совет: на пробном периоде задайте «Лимит в сутки» около 300 — так 10 000 запросов растянутся на месяц.

Способы передвижения: на машине, с учётом пробок (там, где у Mapbox есть данные о пробках), пешком, на велосипеде.

2ГИС #

2ГИС считает расстояния через сервис «Матрица расстояний» (Distance Matrix API). Ключ выдаётся в кабинете «Менеджер Платформы».

Бесплатный демо-ключ, чтобы попробовать:

1. Откройте Платформу 2ГИС и зарегистрируйтесь в «Менеджере Платформы».
2. На вкладке «Главная» нажмите «Создать демо-ключ», введите название ключа и нажмите «Создать».
3. Вставьте ключ в строку «2ГИС», нажмите «Проверить» и «Сохранить».

Демо-ключ можно создать один раз на аккаунт, он действует месяц, а на «Матрицу расстояний» у него 1 000 запросов. Чтобы демо-ключ не кончился за пару дней, задайте «Лимит в сутки» около 30.

Рабочий ключ:

1. На вкладке «Главная» нажмите «Купить подписку» (или «Оставить заявку на покупку»).
2. Выберите срок — месяц или год — и обязательно включите в подписку сервис «Матрица расстояний», указав лимит запросов в месяц.
3. Заполните реквизиты и оплатите. Картой оплата проходит сразу, по счёту — до нескольких дней.
4. Ключ появится на вкладке «Ключи API». Для плагина не включайте у ключа «Использовать для SDK».

Ключ работает со всеми сервисами, которые входят в подписку, поэтому «Матрица расстояний» должна быть в ней. Цены и пакеты — в документации 2ГИС. Описание сервиса — на странице «Матрицы расстояний».

Способы передвижения: на машине, с учётом пробок, пешком, на велосипеде.

Яндекс #

Яндекс считает расстояния через «API Матрицы расстояний». Бесплатного тарифа у этого сервиса нет.

1. Откройте кабинет разработчика Яндекса и войдите с Яндекс ID. Яндекс советует завести отдельный логин для работы с API: ключи потом нельзя перенести на другой логин.
2. При первом входе укажите страну налогового резидентства — потом её не поменять.
3. Нажмите «Подключить API» и выберите «Матрица расстояний».
4. В параметрах тарифа выберите срок, дату начала и дневной лимит запросов, примите оферту и нажмите «Подключить».
5. Выберите плательщика (организация или физическое лицо) и оплатите счёт.
6. Ключ создаётся сам и становится активным с даты начала тарифа. Скопируйте его в разделе «Ключи» на странице продукта.
7. Вставьте ключ в строку «Яндекс», нажмите «Проверить» и «Сохранить».

Яндекс может дать бесплатный тестовый период на несколько дней — его просят через поддержку Яндекса, условия описаны на странице тарифов. Описание сервиса — в документации Яндекса.

Плагин ставит Яндексу «Лимит в сутки» 1 000 — как на минимальном тарифе. Если ваш тариф другой, поменяйте лимит на свой дневной.

Способы передвижения: на машине, с учётом пробок, пешком, на велосипеде.

Google #

Google считает расстояния через Routes API. Для Google нужен платёжный аккаунт Google Cloud с банковской картой, даже если вы укладываетесь в бесплатную квоту.

1. Войдите в Google Cloud Console и создайте проект.
2. Откройте раздел «Billing» и подключите к проекту платёжный аккаунт.
3. Откройте страницу Routes API и нажмите «Enable».
4. Откройте Keys & Credentials, нажмите «Create credentials» → «API key».
5. В «API restrictions» оставьте только Routes API — так ключом нельзя будет воспользоваться для других сервисов Google — и нажмите «Create».
6. Скопируйте ключ, вставьте в строку «Google», нажмите «Проверить» и «Сохранить».

Google берёт деньги за каждый посчитанный маршрут, но даёт бесплатную квоту в месяц; с учётом пробок квота меньше. Подробности — на странице цен Routes API.

Если у вас нет зарубежной (нероссийской) банковской карты, вы можете воспользоваться сервисом Плати по миру.

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

Если вы обновились с версии 1.x и у вас был ключ Google: версия 2 использует Routes API, а не старый Distance Matrix API. Включите Routes API в проекте (шаг 3) и нажмите «Проверить».

Ключ в файле wp-config.php #

Если вы не хотите хранить ключ в настройках сайта, его можно задать константой в файле wp-config.php. Тогда поле ключа в таблице недоступно для редактирования: действует значение из файла.

Сервис	Константа
OpenRouteService	WOODEV_RANGE_RATE_ORS_API_KEY
Mapbox	WOODEV_RANGE_RATE_MAPBOX_ACCESS_TOKEN
2ГИС	WOODEV_RANGE_RATE_2GIS_API_KEY
Яндекс	WOODEV_RANGE_RATE_YANDEX_API_KEY
Google	WOODEV_RANGE_RATE_GOOGLE_API_KEY

Пример строки: define( 'WOODEV_RANGE_RATE_ORS_API_KEY', 'ваш-ключ' );. Добавьте её выше строки «That’s all, stop editing!». Если вы не работали с этим файлом, попросите своего хостинг-провайдера или разработчика.

Что делает плагин, когда сервис не отвечает #

Если сервис карт не смог посчитать маршрут, плагин считает это расстояние по прямой, с вашим коэффициентом дороги. Доставка появится, если для этого расстояния и веса есть подходящая цена; перенесённые из версии 1.x правила, которым нужно время в пути, без ответа сервиса могут скрыть способ доставки. Так происходит, когда:

• у сервиса, выбранного в способе доставки, нет ключа;
• сервис не принял ключ — тогда плагин час не обращается к нему и ждёт, пока вы исправите ключ;
• у сервиса кончились запросы по тарифу или он попросил подождать;
• сервис несколько раз подряд не ответил — тогда плагин делает паузу от нескольких минут до часа и потом пробует снова;
• исчерпан ваш «Лимит в сутки» — новые запросы к сервису прекращаются до конца суток: сохранённые маршруты используются, пока не истечёт срок их хранения, а для остальных адресов расстояние считается по прямой.

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

В заказе в строке «Сервис» в таком случае написано, например, «По прямой (резерв: 2ГИС недоступен)».

Вас плагин предупреждает только о том, что вы можете исправить. В админке появляется красное уведомление со ссылкой «Открыть настройки»:

• «Сервис «…» не принял ключ, поэтому расстояние считается по прямой. Проверьте ключ в настройках.»
• «Сервис «…» отключён, но способы доставки его используют — расстояние считается по прямой. Подключите сервис или выберите другой в настройках способа доставки.»

Уведомление исчезает само, когда сервис снова работает или когда ни один способ доставки им больше не пользуется. Временные сбои связи уведомлений не вызывают — они проходят сами. Если включено «Логирование», каждый такой расчёт по прямой записывается в журнал.

Какой сервис выбрать #

• Начните с «По прямой». Это бесплатно и работает сразу. Для города без рек и больших развязок с коэффициентом 1,3 цена получается близкой к реальной.
• Нужно по дорогам и бесплатно — OpenRouteService.
• Хотите попробовать без карты или у вас немного заказов — Mapbox.
• Важны пробки и российские карты — 2ГИС или Яндекс, по их платным тарифам.
• Уже есть платёжный аккаунт Google — Google.

Сервис можно сменить в любой момент в поле «Расчёт расстояния» способа доставки. Таблицу цен переделывать не придётся.

Остались вопросы? #

Напишите в поддержку — она входит в лицензию.