Карты и адреса: ключи DaData, Яндекс, Mapbox

Подсказки адресов, карта и время в пути работают через внешние сервисы. Ключи к ним вы получаете сами (регистрация бесплатная) и вставляете в Настройки → Карты и адреса — так же устроено, например, у конструкторов сайтов доставки.

Без ключей программа тоже работает: карта — OpenStreetMap, расстояние и время — по дорогам без учёта пробок, адрес ищется по OpenStreetMap. Ключи делают работу удобнее и точнее.

123

• 1Поле ключа (первым — DaData, ниже — Яндекс и Mapbox)
• 2«Проверить» — пробный запрос: «Ключ работает» или понятная ошибка
• 3«Сохранить» — ключи начнут работать сразу

DaData — подсказки адресов (главный ключ)

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

1. Зарегистрируйтесь на dadata.ru.
2. Личный кабинет → «API-ключи».
3. Скопируйте API-ключ (не «секретный») → вставьте в поле DaData → «Проверить» → «Сохранить».

Яндекс Карты — карта и поиск адреса

1. Кабинет разработчика Яндекса (developer.tech.yandex.ru) → «Подключить API» → «JavaScript API и HTTP Геокодер».
2. Скопируйте ключ → вставьте → «Проверить». Новый ключ начинает работать примерно через 15 минут.

Mapbox — время в пути с пробками

1. Зарегистрируйтесь на mapbox.com → раздел Tokens.
2. Скопируйте «Default public token» (начинается с pk.) → вставьте → «Проверить».

Если ключ перестал работать

Закончился лимит, ключ отключили или удалили — программа сама переходит на запасной путь (OpenStreetMap, расчёт без пробок), смена не останавливается. В Настройки → Карты и адреса у этого сервиса появится красное предупреждение — замените ключ.

Чтобы бесплатный лимит не кончался посреди месяца, программа ходит в Mapbox не больше 300 раз в сутки (со своим ключом доставки), а одинаковый маршрут помнит 10 минут. Сверх этого до конца суток время считается по дорогам без пробок.

Время в пути «по опыту»

Внизу страницы Карты и адреса — раздел «Время в пути „по опыту“». Программа сама учится, сколько на самом деле едут ваши курьеры: для каждой поездки к клиенту запоминает, когда курьер выехал (нажал «В пути» или отдал предыдущий заказ), когда подъехал к адресу (по геопозиции из приложения курьера) и сколько та же дорога занимает без пробок. Из этого выводятся поправки на пробки — отдельно по часам, для будней, субботы и воскресенья: например, «в будни с 18 до 19 ехать в 1,6 раза дольше, чем по пустой дороге».

• Поездок за 60 дней — сколько собрано; «доехали» — сколько с известным временем прибытия.
• Mapbox и Наш прогноз — насколько каждый ошибается на одних и тех же поездках.
• Таблица по часам — поправки; бледные — пока мало поездок (по часу поправка начинает действовать с 8 поездок).

Ключи подключаете вы сами и сами соблюдаете условия выбранных сервисов (см. оферту, п. 5.3).