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

# Получение сегментов маршрута

<iframe id="LIVE-EXAMPLE" style="width:100%;height: 400px;border-radius: 8px;border: 1px solid rgba(92, 94, 102, 0.14);" frameBorder="0" src="https://yastatic.net/s3/front-maps-static/maps-front-jsapi-v2-1/examples/2/out/s3-cases/ru/router/index.html" allow="fullscreen"></iframe>

<a target="_blank" rel="noopener noreferrer" style="display: inline-block;margin-top: 10px;cursor: pointer;border-radius: 4px;padding: 9px 12px;background: #151515;color: white;text-decoration: none;font-weight: 500" href="https://codesandbox.io/p/sandbox/tk23kk?file=index.html">Open in CodeSandbox</a>

<div id="references">
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ready">ready</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map">Map</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.GeoObjects">map.GeoObjects</a>,
    <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/route">route</a>
</div>
<p>
	Для построения <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/router">маршрута</a> предназначена функция <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/route">route</a>. В эту функцию передается массив точек, через которые нужно проложить маршрут и, при необходимости, дополнительные опции его построения.
</p>
<p>
	Вычисление маршрута производится асинхронно (то есть во время выполнения функции route производится обмен данными с сервером). Результат передается в функцию-обработчик в виде коллекции <a href="https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/GeoObjectCollection">GeoObjectCollection</a>, которую можно разместить на карте.
</p>

{% list tabs %}

-   index.html

    ```html
    <!DOCTYPE html>

    <html>
        <head>
            <title>Получение сегментов маршрута</title>
            <meta
                http-equiv="Content-Type"
                content="text/html; charset=utf-8"
            />
            <!--
            Укажите свой API-ключ. Тестовый ключ НЕ БУДЕТ работать на других сайтах.
            Получить ключ можно в Кабинете разработчика: https://developer.tech.yandex.ru/keys/
        -->
            
            
            
            
        </head>

        <body>
            <div id="map"></div>
            <div id="list"></div>
        </body>
    </html>
    ```

-   router.js

    ```js
    ymaps.ready(init);

    function init() {
        var myMap = new ymaps.Map(
            "map",
            {
                center: [55.745508, 37.435225],
                zoom: 13,
            },
            {
                searchControlProvider: "yandex#search",
            }
        );

        // Добавим на карту схему проезда
        // от улицы Крылатские холмы до станции метро "Кунцевская"
        // через станцию "Молодежная" и затем до станции "Пионерская".
        // Точки маршрута можно задавать 3 способами:
        // как строка, как объект или как массив геокоординат.
        ymaps
            .route([
                "Москва, улица Крылатские холмы",
                {
                    point: "Москва, метро Молодежная",
                    // метро "Молодежная" - транзитная точка
                    // (проезжать через эту точку, но не останавливаться в ней).
                    type: "viaPoint",
                },
                [55.731272, 37.447198], // метро "Кунцевская".
                "Москва, метро Пионерская",
            ])
            .then(
                function (route) {
                    myMap.geoObjects.add(route);
                    // Зададим содержание иконок начальной и конечной точкам маршрута.
                    // С помощью метода getWayPoints() получаем массив точек маршрута.
                    // Массив транзитных точек маршрута можно получить с помощью метода getViaPoints.
                    var points = route.getWayPoints(),
                        lastPoint = points.getLength() - 1;
                    // Задаем стиль метки - иконки будут красного цвета, и
                    // их изображения будут растягиваться под контент.
                    points.options.set("preset", "islands#redStretchyIcon");
                    // Задаем контент меток в начальной и конечной точках.
                    points
                        .get(0)
                        .properties.set("iconContent", "Точка отправления");
                    points
                        .get(lastPoint)
                        .properties.set("iconContent", "Точка прибытия");

                    // Проанализируем маршрут по сегментам.
                    // Сегмент - участок маршрута, который нужно проехать до следующего
                    // изменения направления движения.
                    // Для того, чтобы получить сегменты маршрута, сначала необходимо получить
                    // отдельно каждый путь маршрута.
                    // Весь маршрут делится на два пути:
                    // 1) от улицы Крылатские холмы до станции "Кунцевская";
                    // 2) от станции "Кунцевская" до "Пионерская".

                    var moveList = "Трогаемся,</br>",
                        way,
                        segments;
                    // Получаем массив путей.
                    for (var i = 0; i < route.getPaths().getLength(); i++) {
                        way = route.getPaths().get(i);
                        segments = way.getSegments();
                        for (var j = 0; j < segments.length; j++) {
                            var street = segments[j].getStreet();
                            moveList +=
                                "Едем " +
                                segments[j].getHumanAction() +
                                (street ? " на " + street : "") +
                                ", проезжаем " +
                                segments[j].getLength() +
                                " м.,";
                            moveList += "</br>";
                        }
                    }
                    moveList += "Останавливаемся.";
                    // Выводим маршрутный лист.
                    $("#list").append(moveList);
                },
                function (error) {
                    alert("Возникла ошибка: " + error.message);
                }
            );
    }
    ```

{% endlist %}
