API для построения и оптимизации маршрутов
Тот же расчёт, что работает в планировщике, можно встроить в вашу учётную систему, сайт или мобильное приложение. Адреса уходят в API, обратно приходит готовый маршрут - с порядком объезда, пробегом и распределением заказов между исполнителями. Разбираем простыми словами, что это даёт бизнесу, и отдельно - что нужно знать разработчику.
Короткий ответ
API - это способ, которым одна программа просит другую что-то посчитать. Ваша система (1С, CRM, интернет-магазин, своё приложение) отправляет список адресов, а в ответ получает готовый маршрут. Человеку не нужно копировать адреса в планировщик и обратно: маршрут появляется там, где уже живут заказы.
API умеет три вещи:
- Построить маршрут по списку адресов: найти каждый адрес на карте и посчитать пробег по дорогам.
- Найти оптимальный порядок объезда, при котором машина проезжает меньше всего километров.
- Распределить заказы между исполнителями - курьерами, водителями, выездными мастерами - так, чтобы у каждого был свой разумный маршрут.
Доступ выдаём по заявке: форма внизу страницы.
Что это даёт бизнесу
Если маршруты у вас сейчас собирает логист руками, API убирает из его дня механическую часть. Не нужно раскладывать заказы по районам, прикидывать, кто куда успеет, и переносить адреса между программами.
- Меньше километров. Порядок, посчитанный машиной, на двадцати адресах обычно заметно короче аккуратного ручного - разбор с цифрами в статье как объехать 20 адресов за смену. Экономия повторяется каждую смену у каждой машины.
- Меньше ручной работы. Маршруты на день собираются за секунды после того, как заказы попали в систему, а не к обеду.
- Одинаковое качество каждый день. Результат не зависит от того, опытный логист сегодня на смене или новичок.
- Всё в одной системе. Маршрут приходит туда же, где заказы, клиенты и отчёты, - без выгрузок и таблиц посередине.
Кому и как пригодится
| Кто читает | Что важно | Что даёт API |
|---|---|---|
| Руководитель | Затраты на транспорт и людей | Меньше пробега и часов за рулём, логист занят исключениями, а не рутиной |
| Логист, диспетчер | Собрать смену быстро и без ошибок | Готовый порядок и раскладка заказов по машинам, остаётся проверить и поправить |
| Разработчик | Как встроить и что вернётся | HTTPS-запросы с ответом в JSON, документация и тестовый доступ после заявки |
Как это выглядит в работе
Обычный день службы доставки с подключённым API выглядит так:
- Заказы на завтра собираются в вашей системе, как и раньше.
- Вечером или утром система отправляет в API адреса заказов, точку старта (склад) и список исполнителей на смене.
- API находит адреса на карте, делит заказы между исполнителями и для каждого считает оптимальный порядок объезда.
- Ответ возвращается в вашу систему: у каждого заказа появляется исполнитель и номер в маршруте, у каждого маршрута - пробег.
- Логист смотрит результат, при необходимости что-то двигает руками и отправляет маршруты водителям.
Если учётной системы нет, а маршрут нужен разово, API не обязателен: хватит планировщика в браузере.
Для разработчиков
- Протокол. Обычные HTTPS-запросы, ответы в JSON. Вызвать можно из любого языка и из любой платформы, где есть HTTP-клиент.
- Доступ. По ключу, который выдаём после заявки. Вместе с ключом приходит документация по методам и примеры запросов.
- Адреса. Можно передавать адреса строкой - API сам найдёт координаты - или сразу координатами, если они у вас уже есть. Координаты надёжнее: ошибка поиска адреса исключена.
- Маршрут. Точку старта можно задать явно, финиш - закрепить или оставить кольцевым с возвратом на склад.
- Распределение. На вход - заказы и исполнители, на выход - кто какие заказы везёт и в каком порядке.
- Расстояния. Считаются по дорожной сети, а не по прямой: у каждого маршрута будет реальный пробег в километрах.
Технические детали - лимиты на размер запроса, формат полей, скорость ответа - зависят от задачи, поэтому обсуждаем их после заявки, а не обещаем заранее.
Чего API не делает
- Пробки не учитываем. Расстояния считаются по дорожной сети в километрах, данных о заторах в расчёте нет.
- Не ведёт водителя по дороге. API считает порядок точек, а между точками водитель едет по привычному навигатору.
- Не заменяет учётную систему. Заказы, клиенты и статусы остаются у вас, API только считает маршруты.
Как получить доступ
Заявка на доступ к API
Достаточно имени и контакта. Остальное поможет подготовить ответ быстрее.
Заявка отправлена
Спасибо! Мы свяжемся с вами по указанному контакту.
Частые вопросы
Нужен ли программист, чтобы подключить API?
Да, подключение - это работа разработчика: вашего штатного, подрядчика или того, кто поддерживает вашу учётную систему. Если программиста нет, для разовых маршрутов подойдёт планировщик в браузере, он работает без подключения.
Чем API отличается от планировщика на сайте?
Считают они одинаково. Планировщик - это окно для человека: вставил адреса, получил маршрут. API - это вход для программы: ваша система сама отправляет адреса и сама получает результат, без копирования руками. Распределение заказов между несколькими исполнителями есть только в API.
Можно ли распределить заказы между несколькими курьерами?
Да, это одна из основных задач API. Вы передаёте заказы и список исполнителей, а в ответ получаете, кто какие заказы везёт и в каком порядке.
Учитывает ли API пробки?
Нет. Расстояния считаются по дорожной сети в километрах, данных о заторах в расчёте нет.
Сколько стоит доступ?
Условия зависят от объёма: сколько адресов и исполнителей в день. Тестовый доступ для проверки на своих адресах выдаём после заявки, а условия постоянного подключения обсуждаем по её итогам.
Как быстро ответят на заявку?
Заявка сразу приходит нам на почту и в рабочий чат. Ответим по контакту, который вы указали в форме.