---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/dg/concepts/router/about.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/router/about.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt

# Маршрутизация

[Общие сведения](#general)

[Способы построения маршрута](#section_axs_1ch_xdb)

[Основные понятия](#section_sss_r5x_k2b)

## Общие сведения {#general}

Маршрутизатор — сервис для построения маршрутов на карте. Сервис позволяет автоматически вычислять маршрут между заданными пунктами и получать информацию о проложенном маршруте (протяженность, время преодоления). Маршруты можно строить как с учетом пробок, так и без.

Доступны следующие типы маршрутизации:

- на автомобиле,
- пешеходные,
- на общественном транспорте,
- на велосипеде.

Для заданных точек API строит несколько оптимальных маршрутов. Самый быстрый маршрут устанавливается в качестве активного. Он отображается на карте фиолетовым цветом. Альтернативные маршруты отображаются серым цветом. По клику пользователи смогут переключаться между маршрутами.


{% note alert %}

Запросы к маршрутизации [тарифицируются](https://yandex.ru/maps-api/products/js-api#tariffs).

{% endnote %}


## Способы построения маршрута {#section_axs_1ch_xdb}

Построить маршрут на карте можно следующими способами:

#|
|| **Способ** | **Описание** ||
|| через [Панель маршрутизации](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/router/routePanel.md)

![](../../_images/route-panel-small-size.png) |

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

Панель маршрутизации позволяет программно задавать точки маршрута, а также выбирать тип маршрутизации.

**Преимущества**
- Удобный интерфейс: пользователи сами управляют маршрутом.
- Позволяет строить маршруты с возможностью вызова такси. [Подробнее](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/router/routePanel.md#how-to-use-taxi)

**Недостатки**

- Не поддерживает промежуточные точки — маршруты можно строить только по двум точкам. ||
|| на уровне кода, с помощью класса [multiRouter.MultiRoute](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/router/multiRouter.md)

![](../../_images/route-ex-small.png) | Управление маршрутизацией на уровне программного кода.

**Преимущества**
- Позволяет строить составные маршруты по неограниченному числу точек.
- Позволяет строить маршруты на велосипеде.

**Недостатки**

- Более сложная реализация. ||
|#


## Основные понятия {#section_sss_r5x_k2b}

_Мультимаршрут_ — базовый объект для работы с маршрутизацией. Он содержит информацию о построенных маршрутах: геометрию, данные о точках, время в пути и т. д. Мультимаршрут обрабатывает эти данные и создает представление для отображения маршрутов на карте.

_Активный маршрут_ — основной маршрут. Отображается на карте фиолетовым цветом. По умолчанию в качестве активного маршрута выбирается самый быстрый маршрут из числа построенных.

_Путевая точка_ (или _точка остановки_) — точка маршрута, в которой нужно сделать остановку. К путевым точкам также относятся начальная и конечная точки. На карте путевые точки обозначаются метками с латинскими буквами. Например, «A», «B», «C».

_Транзитная точка_ — промежуточная точка, через которую нужно проложить маршрут, но в которой не подразумевается остановка. Транзитные точки доступны только для автомобильной маршрутизации.

_Путь_ — линия маршрута, которая соединяет путевые точки. На рисунке ниже у маршрута два пути. Первый путь: между точками «A» и «B»; второй путь: между точками «B» и «C». У маршрутов, построенных через панель маршрутизации, будет всегда один путь.

_Сегмент_ — это отрезки маршрута между:
- путевыми или транзитными точками;
- точками возможного изменения направления движения (развилка, въезд, съезд, поворот, разворот, перекресток);
- точками, в которых меняется тип участка. Например, сегмент «пешком» меняется на сегмент «на автобусе».

На рисунке ниже сегмент обозначен синим цветом.

![](../../_images/terms.png)