API
Лучшие практики использования API навигации для автоматизации логистики и доставки в мобильных сервисах
Как использовать API навигации 2ГИС в мобильных сервисах: VRP/TSP, матрицы расстояний, ETA, map matching и SLA‑аналитику для снижения стоимости доставки.
Быстрый путь к снижению cost-per-drop, устойчивым ETA и бесшовной last-mile дает стек готовых маршрутизаторов и мобильных SDK. Центральное звено — API навигации, которое объединяет построение маршрутов, матрицы расстояний, TSP/VRP и учет ограничений для разных профилей движения.
Снижение расходов на флит: динамическая оптимизация маршрутов для экономии топлива и времени
Когда статическая маршрутизация перестает работать
При росте доли срочных слотов и мульти-заказов статические планы увеличивают холостой пробег и срывы слотов. Динамический пересчет маршрутов с учетом пробок, перекрытий и отмен снижает пустые километры и стабилизирует время подачи.
Distance Matrix + TSP/VRP: базовый пайплайн
Эффективная схема — расчеты матрицы расстояний по батчам, затем оптимизация порядка точек TSP или распределение заказов VRP с временными окнами и вместимостью. Асинхронный расчет матрицы используется для больших партий, чтобы держать низкую латентность при пиках.
Пример JSON запроса VRP (endpoint для запроса указывается как текст без ссылки): routing.api.2gis.com/logistics/vrp/1.1.0/create?key=API_KEY
{
"couriers":[{"id":"c1","working_hours":["08:00-18:00"],"capacity":150}],
"orders":[{"id":"o1","point":[55.75,37.62],"service_time_sec":600,"time_windows":["08:00-10:00"],"load":50}],
"depot":{"id":"d1","point":[55.73,37.60]},
"options":{"objective":"time"}
}
Пример JSON для Distance Matrix Async
{
"origins":[[55.73,37.60],[55.75,37.61]],
"destinations":[[55.76,37.64],[55.77,37.66]],
"profile":"car",
"traffic":"live"
}
Динамический пересчет при пробках, инцидентах, отменах
Пробки и перекрытия учитываются в момент построения и при изменениях на линии. Полезно вводить гистерезис — пересчитывать только при существенных сдвигах ETA или изменении статуса заказа. Плановые пересчеты с периодом 3-5 минут дают баланс между стабильностью и точностью.
Ограничения грузовиков: масса, габариты, зоны
Профиль грузового транспорта требует учета ПДД-зон с запретами для грузовиков, массы, габаритов, типа груза, ширины дорог и радиусов поворота. В запросах задается профиль transport=»truck» и транспортные параметры. Для оценки кратчайшего пути доступна опция type=»shortest», а для расчета ETA допускается верхняя граница скорости.
Практики
- Комбинировать асинхронные матрицы, TSP и VRP с временными окнами и ограничениями по вместимости.
- Учитывать live traffic и инциденты, но применять гистерезис, чтобы исключить избыточные перестроения.
- Кэшировать частые пары, использовать batch-запросы и регулярные пересчеты каждые 3-5 минут.
Метрики: cost-per-drop, средний пробег на заказ, доля пустых километров, среднее время на маршрут.
Повышение точности ETA в мобильных сервисах для роста удовлетворенности клиентов и удержания
Источники ошибок ETA и как их устранять
Ошибки возникают из-за неточного геокодирования, GPS-шума, незнания внутридворовых проездов и шлагбаумов, а также при резких изменениях трафика. Устойчивость растет при точной постановке стартовых и конечных точек, учете дворовых проездов и запретов на въезд, а также при оперативной корректировке по фактическому движению.
Map matching и фильтрация GPS для стабильного прогресса
Сопоставление трека с дорожным графом сглаживает шум, устраняет «пилу» и снижает скачки ETA. По данным навигационного стека достигается точность до 95 процентов при регулярном обновлении карты. Обновления ETA стоит запускать по событиям — смена сегмента, скорости или полосы.
Прогноз пробок и сезонность, cold-start стратегия
Прогноз пробок стабилизирует ETA в пиковые часы. Cold-start компенсируется сегрегацией моделей по профилям движения и типам зон — центральные улицы, дворы, магистрали.
Точное геокодирование «до двери» и дворовые проезды
Построение до входов требует знания заборов, калиток и переходов для пешеходов, а также внутридворовых проездов, шлагбаумов и зон ограниченного въезда для авто. Навигация с подсказками по полосам снижает ошибки перестроений на сложных развязках.
Пример JSON для Map Matching
{
"points":[[55.75,37.62,1712231123],[55.751,37.625,1712231128],[55.752,37.63,1712231133]],
"profile":"car"
}
Метрики: MAE/MAPE по ETA, доля доставок в слот OTD, NPS, удержание заказов.
Автоматическое распределение и перераспределение заказов при пиковых нагрузках с помощью API навигации
Архитектура оркестратора: очередь — матрица — VRP — диспетчер
Поток заказов поступает в очередь, где формируются батчи для расчета матрицы. Результаты передаются в VRP для распределения по курьерам, затем диспетчер обновляет статусы и маршруты. Масштабируемая архитектура распределяет входящие запросы между несколькими инстансами маршрутизатора, что поддерживает стабильные пересчеты при пиках.
Асинхронные матрицы для больших партий
Асинхронный Distance Matrix подходит для массивов заказов — снижается задержка и нагрузка на фронт. Для надежности вводятся retry-схемы с идемпотентностью и backpressure, чтобы стабилизировать очереди.
Правила перераспределения: отмены, задержки, новые заказы
Алгоритм учитывает отмены, срывы временных окон и новые заказы по ходу маршрута. Приоритизация строится от SLA и ценности заказа, разрешена миграция задач между курьерами в пределах зон покрытия и рабочих окон.
Практики
- Использовать Async Distance Matrix для партийных расчетов и VRP для распределения с ограничениями.
- Вводить лимиты на частоту перерасчетов и пороги срабатывания, чтобы исключить «дергание» маршрутов.
- Учитывать перекрытия по данным Restrictions API и оптимизировать порядок точек с помощью TSP.
Метрики: время подтверждения, доля перераспределенных заказов в SLA, устойчивость системы при пиковых нагрузках.
Оркестрация last-mile и многомодальной доставки: сокращение простоев и ускорение исполнения
Профили маршрутизации: пеший, авто, грузовой, микромобильность
Разные участки маршрута требуют разных профилей. Пешеходный профиль учитывает заборы, калитки и переходы. Автомобильный — зоны ограниченного въезда, шлагбаумы и внутридворовые проезды. Для грузового профиля учитываются ПДД-запреты, масса и габариты. Навигация для такси использует подсказки по полосам, трафик и прогноз пробок для точного времени подачи.
Доступы и препятствия: калитки, шлагбаумы, дворы, ПДД-зоны
Последние метры решают SLA. Учет реальных препятствий и физических ограничений снижает «поисковку входа», а значит сокращает задержки на доставке и подаче.
Навигация по полосам и подсказки водителю
Подсказки по полосам уменьшают пропуски съездов и лишние круги, что влияет на расход топлива и удержание слотов.
Метрики: время поиска входа, доля неудачных подач, среднее время подъезда к адресу.
Ускорение внедрения мобильных функций и снижение TCO через готовые маршрутизаторы и API навигации
Build vs Buy: что экономит 6-12 месяцев
Готовые маршрутизаторы, Distance Matrix и TSP ускоряют внедрение за счет стандартных JSON-профилей, батч-операций и асинхронных задач. Mobile SDK закрывает карту, поиск и навигацию, включая офлайн-режим — критично для эффективности батареи и стабильности в полевых условиях.
Off-the-shelf SDK: карта, поиск, навигация, офлайн
Mobile SDK для iOS/Android поддерживает маршруты для легковых и грузовых авто, общественного транспорта, велосипедов, самокатов и пешеходов с расчетом ETA и RTA. Tiles и Markers API формируют легкий интерфейс с экономией трафика и без роста веса приложения.
Управление стоимостью: кэширование, batch, квоты, on-prem
Снижение TCO достигается кэшированием частых пар, пакетными расчетами и контролем квот. Для требований безопасности доступно on-premise развертывание и офлайн-работа с автоматическими обновлениями без простоя. Переход на стек дает экономию 600 000 ₽ в год — показатель совокупной выгоды для бизнеса.
Контроль SLA и аналитика эффективности маршрутов для операционной зрелости логистики
Карта охвата и изохроны для планирования зон
Аналитика в 2ГИС Про показывает радиусы доступности и зоны 20 минут вдоль действующих маршрутов. Это помогает оценить охват магазинов и потенциальные точки роста.
Сопоставление плана и факта: треки против маршрутов
Сопоставление GPS-датчиков с дорожным графом дает точную реконструкцию пути, контроль прогресса и расчет фактических параметров. Отчеты по периодам показывают задержки на этапах pickup, linehaul и drop.
Дашборды и отчеты: SLA, «узкие места», A/B-эксперименты
Дашборд фиксирует прогресс маршрутов, активность водителей, последнюю задачу и геопозицию на карте. Фильтры выявляют неохваченные точки и «черные зоны» геокодирования. Геометрии задач экспортируются во внешние системы для дополнительной проверки и аудита.
Метрики: SLA по слотам, задержки на этапах, экономия километров и часов, повторные заезды.
Мини-кейсы и доказательства результата
Дистрибуция в регионе. Проект АПК Архангельская область показал, как карта охвата и анализ транспортной доступности выявляют территории без присутствия. Переразметка зон улучшила маршруты и охват торговых точек.
Стабильность ETA. Точность до 95 процентов в сочетании с map matching и прогнозом пробок снижает отмены и повышает долю доставок в слот.
Экономика флита. Переход на решения 2ГИС дает экономию 600 000 ₽ в год за счет сокращения пробега, холостых километров и времени на маршрут.
Чек-лист внедрения на 30 дней
- Неделя 1 — подключение матриц расстояний и базового Directions, настройка профилей и кэширования, фиксация эталонных метрик.
- Неделя 2 — пилот VRP/TSP на части флитов, периодический пересчет каждые 3-5 минут, правила гистерезиса и квоты.
- Неделя 3 — интеграция мобильного SDK с офлайн-пакетами, map matching, события прогресса, подсказки по полосам.
- Неделя 4 — дашборды SLA и изохроны, экспорт GeoJSON для аудита, A/B по зонам и окнам, финальный отчет по эффекту.
Подводные камни и как их обходить
Геокодирование до входов влияет на ETA — стоит заранее выявлять «черные точки» и настраивать fallback-поиск. Слишком частые пересчеты приводят к нестабильному поведению на линии — гистерезис и пороги по сдвигам ETA решают задачу. Квоты и rate limits требуют батч-стратегии и подготовленных матриц. На мобильной стороне важен бережный режим GPS и офлайн-карты для снижения расхода батареи. Для грузовых — соблюдение ПДД-зон, массы и габаритов, учет дворов и шлагбаумов. Для приватности — on-prem и автономные обновления без простоя.
Фрагменты полезных запросов
Directions с профилями
{
"origin":[55.73,37.60],
"destination":[55.76,37.64],
"profile":"truck",
"options":{"type":"Shortest","max_speed_kph":60}
}
TSP оптимизация порядка
{
"start":[55.73,37.60],
"points":[[55.75,37.62],[55.77,37.66],[55.76,37.64]],
"objective":"time"
}
Почему стек работает как операционная платформа
Навигационные API — это единая ткань планирования, навигации и аналитики: VRP и матрицы сокращают пробег, map matching удерживает ETA, профили учитывают реальные ограничения, а 2ГИС Про закрывает контроль SLA. Единый стек снижает TTFV и позволяет перейти к измеримому ROI за 4-8 недель без тяжелой внутренней разработки.
Часто задаваемые вопросы
Как повысить точность ETA без роста нагрузки на разработку?
Комбинация map matching, прогноза пробок и корректного профиля движения повышает точность до 95 процентов. Обновление по событиям и порогам снижает пересчеты и нагрузку.
Что использовать для распределения заказов в пиковые часы?
Асинхронные матрицы расстояний для партийных расчетов и VRP с временными окнами и вместимостью. Перераспределение идет по правилам SLA и ценности заказа.
Как учесть ограничения для грузовиков?
Профиль transport=truck с параметрами массы, габаритов и типа груза. В расчетах учитываются ПДД-зоны, ширина дорог и радиусы поворота.
Какие инструменты помогают контролировать SLA?
Дашборды 2ГИС Про — радиусы доступности, прогресс маршрутов и активность водителей, сопоставление плана и факта, отчеты за произвольный период с экспортом геометрий во внешние системы.
Контакты и следующий шаг
Доступна консультация и демо. Тестовый ключ выдается бесплатно. Контакты: dev@2gis.ru, 8 966 500-00-50, 8 800 200-36-00.
-
Аналитика магазинов2 недели назад
Мобильный рынок Ближнего Востока: исследование Bidease и Sensor Tower выявляет драйверы роста
-
Интегрированные среды разработки3 недели назад
Chad: The Brainrot IDE — дикая среда разработки с играми и развлечениями
-
Новости4 недели назад
Видео и подкасты о мобильной разработке 2025.45
-
Новости3 недели назад
Видео и подкасты о мобильной разработке 2025.46

