Обзор навигационных API 2ГИС
Используйте навигационные API 2ГИС для построения маршрутов и получения информации о длине маршрута и времени в пути.
Routing API помогает строить маршруты на карте для разных видов транспорта: автомобилей, такси, велосипедов, самокатов, мотоциклов и т. д. Вы можете добавлять промежуточные точки, строить кратчайшие по времени или расстоянию маршруты, исключать определённые области, а также учитывать пробки, дорожные перекрытия, выделенные полосы, лестницы, препятствия и другие параметры.
Для каждого маршрута вы можете получить длину, время в пути и полную геометрию, информацию о высотах (только для некоторых способов передвижения) и о специальных точках (например, начале платного участка дороги).
Попробуйте построить маршрут с Routing API:
Чтобы строить маршруты проезда на общественном транспорте, используйте Public Transport API. С его помощью вы можете получить несколько вариантов проезда за один запрос и информацию о пересадках, остановках, платформах, длине пешеходной части маршрута и других параметрах.
Для вычисления расстояний и времени в пути между несколькими точками отправления и прибытия используйте Distance Matrix API. API позволяет оптимизировать маршруты (например, для курьерской доставки) и решать задачи логистики.
Укажите точки на карте и способ передвижения, чтобы получить данные для каждой пары точек. Например, для трёх точек отправления и трёх точек прибытия API рассчитает матрицу с расстоянием и временем в пути для девяти вариантов маршрутов. Вы можете рассчитать матрицу до 1000 точек: в этом случае используется асинхронный режим работы API.
Пример использования Distance Matrix API в синхронном режиме:
TSP API решает задачу коммивояжёра и находит оптимальные маршруты для обхода нескольких точек курьерами. При необходимости API оптимизирует маршрут по времени или расстоянию и исключает курьеров, если задачу можно решить с меньшими затратами. Вы можете указать способ передвижения курьеров, временные окна работы точек и время работы курьеров, вместимость курьеров и другие параметры. API работает в асинхронном режиме.
Попробуйте построить маршрут с TSP API:
Isochrone API строит на карте зоны доступности — области, до границ которых можно добраться от заданной точки за определённое время или наоборот, от границ до точки. Вы можете строить зоны доступности для разных видов транспорта.
Пример использования Isochrone API:
Map Matching API позволяет восстановить автомобильный маршрут по точкам, зафиксированным транспортным средством. Запрос возвращает полную геометрию маршрута, включая его длину и время в пути.
Route Planner API помогает построить наиболее эффективный маршрут, проходящий через все дороги внутри полигона. API можно использовать для сценариев, в которых необходимо проехать по определённым улицам: например, для организации работы уборочной техники.
Radar API помогает определить приблизительное местоположение устройства при отсутствии спутникового сигнала, а также при нестабильной работе других систем геопозиционирования. Radar API определяет местоположение по точкам доступа Wi-Fi и сотовым вышкам.
Подробные примеры запросов и справочники параметров доступны в документации для каждого навигационного API.
FAQ
Как начать работать с API навигации?
Чтобы работать с API, нужно получить ключ доступа:
- Зарегистрируйтесь в личном кабинете Менеджер Платформы.
- Создайте демо-ключ или купите подписку для доступа к API.
- Изучите пример запросов и ответов в документации к нужному API.
Как рассчитывается стоимость использования API?
Стоимость использования API навигации может рассчитываться по количеству запросов к API, количеству построенных маршрутов или количеству расчётов времени и расстояния между парами точек. Подробнее о способе расчёта см. в разделе Тарифы на странице каждого API.
Можно ли использовать API навигации бесплатно?
Вы можете оформить демо-ключ доступа для тестирования API навигации на один месяц.
Как отслеживать фактическое использование API-ресурсов?
Вы можете отслеживать прогресс расходования лимитов по сервисам и статистику распределения запросов в личном кабинете Менеджер Платформы. Подробнее см. в разделе Статистика.
Как контролировать потребление API-ресурсов?
Чтобы избежать преждевременного исчерпания лимитов, вы можете ограничить использование API-ресурсов вашими приложениями. В личном кабинете Менеджер Платформы доступно несколько способов настройки ограничений:
- Установить лимиты на запросы к конкретным сервисам по всем API-ключам в подписке или по отдельным ключам. Превышение лимитов заблокирует использование продукта: запросы к API будут возвращать ошибку.
- Настроить отправку уведомлений при приближении к лимитам.
Подробнее см. в разделе Управление ключами доступа.
Как получить информацию о пробках?
Routing API, Distance Matrix API, TSP API, Isochrone API и Route Planner API поддерживают учёт текущих или статистических данных о дорожной обстановке, чтобы наиболее точно рассчитать оптимальный маршрут и время в пути. Отдельно информация о пробках не предоставляется.
Как быстро обновляются данные о дорожной обстановке?
Информация о дорожной обстановке (пробки и перекрытия) обновляется в 2ГИС раз в несколько минут и становится доступна в ваших проектах одновременно с продуктами 2ГИС.
Как отобразить маршрут на карте?
- Для веб-приложений: установите векторную карту с помощью MapGL JS API и отобразите маршрут с помощью плагина Directions. Подробнее см. в разделе Построение маршрутов.
- Для мобильных приложений: инициализируйте мобильный SDK 2ГИС и используйте инструменты для создания карты и построения маршрутов. Подробнее см. в разделе Навигация в документации SDK для iOS, Android или Flutter.
Как создать навигатор по построенному маршруту?
Используйте мобильный SDK 2ГИС для создания навигатора по построенному маршруту. SDK предоставляет инструменты для отслеживания местоположения пользователя, поиску альтернативных маршрутов в пути, голосовых подсказок и других функций навигатора. Подробнее см. в разделе Навигация в документации SDK для iOS, Android или Flutter.
Нет ответа на мой вопрос
Воспользуйтесь поиском по документации или отправьте электронное письмо на api@2gis.ru.