Геозоны

Геозоны позволяют задавать ограничения при планировании с учетом характеристик автомобилей, условий доступа и особенностей местности. Подробнее об этом см. в разделе Транспортное средство.

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

Если заказы связаны между собой типами pickup и delivery, и один из заказов принадлежит к геозоне, то связанный с ним заказ также будет относиться к этой зоне.

Ескерту

Вы можете добавить не больше 500 геозон для одной компании.

Чтобы отменить ограничения для одного или нескольких заказов в маршруте, используйте параметр ignore_zones_compatibility. Подробнее об этом см. в разделе Несовместимость заказов с учетом геозон.

Геозоны в интерфейсе

Работать с геозонами из cправочника можно через интерфейс Планирования. Для этого:

  1. Определите геозоны в разделе СправочникиГеозоны (подробнее см. Справочник геозон).
  2. Спланируйте маршрут с помощью Excel-файла.
  3. На вкладке Настройки при определении настроек оптимизации выберите Учитывать геозоныДа.

При планировании заказы по координатам будут автоматически отнесены к нужным зонам.

Также можно использовать публичные геозоны.

Геозоны в API

Работать с геозонами в API можно следующими способами:

Методы API для работы с геозонами

Методы API удобно использовать в следующих ситуациях:

  • вы создаете и редактируете зоны в стороннем сервисе, актуализируете справочник геозон в Маршрутизации с помощью методов добавления, изменения и удаления геозон, а затем используете этот справочник для планирования;

    Пример JSON

    В примере задается геозона с названием zone_1 и пустой областью внутри. Геозона будет окрашена в зеленый цвет при просмотре через интерфейс.

    [
    {
        "number": "zone_1",
        "polygon": {
        "type": "Polygon",
        "coordinates": [
            [
            [
                37.453341832031036,
                55.47515872719678
            ],
            [
                37.41900955664041,
                55.42715840626307
            ],
            [
                37.466388096679474,
                55.36384893358992
            ],
            [
                37.609897007812286,
                55.36658663328021
            ],
            [
                37.69916092382792,
                55.42832984374252
            ],
            [
                37.6126435898435,
                55.48412788836129
            ],
            [
                37.51788650976538,
                55.4899762368179
            ],
            [
                37.453341832031036,
                55.47515872719678
            ]
            ],
            [
            [
                37.49866043554666,
                55.44862921459692
            ],
            [
                37.58174454199197,
                55.454482853927836
            ],
            [
                37.616763462890425,
                55.41231717677708
            ],
            [
                37.515826573241974,
                55.39668877847346
            ],
            [
                37.49866043554666,
                55.44862921459692
            ]
            ]
        ]
        },
        "color_edge": "rgb(0,179,65)",
        "color_fill": "rgb(0,179,65)"
    }
    ]
    
  • вы создаете и редактируете геозоны в интерфейсе Маршрутизации, а затем загружаете их в свою корпоративную систему с помощью методов Получить зону компании или Получить справочник зон компании. Также вы можете использовать методы Получить публичную геозону и Получить справочник публичных геозон.

Чтобы работать с геозонами с помощью API, отправьте запрос к ресурсу mvrp с OAuth авторизацией:

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d <тело запроса> https://courier.yandex.ru/api/v1/vrs/add/mvrp

В заголовке Authorization: OAuth <ваш-токен> вместо <ваш-токен> укажите OAuth-токен, полученный для работы с Мониторингом.

Назар аударыңыз

Путь в запросе с авторизацией (с OAuth-токеном) отличается от пути, указанного в спецификации (с API-ключом).

Описание геозон с помощью координат

Чтобы задать координаты геозон непосредственно в задаче планирования, в запросе создайте объект zones. Каждый элемент этого объекта описывает одну зону и содержит координаты вершин многоугольника.

Для получения координат воспользуйтесь инструментами Конструктора карт Яндекса:

  1. Нарисуйте зону при помощи инструмента Многоугольники (подробнее см. в разделе Создание объекта Справки Конструктора карт).

  2. Нажмите Сохранить и продолжитьЭкспорт (подробнее см. в разделе Экспорт объектов карты Справки Конструктора карт).

  3. Выберите GeoJSONСкачать.

  4. Используйте объект geometry в запросе для формирования объекта zones.

    Пример описания геозоны в запросе
            "zones": [
            {
                "id": "zone1",
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [
                        [
                            [
                                37.3890158054755,
                                55.8142956464218
                            ],
                            [
                                37.4755331394599,
                                55.7415407888477
                            ],
                            [
                                37.5716635105537,
                                55.7984405246533
                            ],
                            [
                                37.5847097752021,
                                55.799987651288
                            ],
                            [
                                37.3890158054755,
                                55.8142956464218
                            ]
                        ]
                    ]
                }
            }
         ]
    

Чтобы использовать описание геозон с помощью координат, отправьте запрос к ресурсу mvrp:

curl -H "Content-Type: application/json" -X POST -d <тело запроса> https://courier.yandex.ru/vrs/api/v1/add/mvrp?apikey=<API-ключ>
Написать в службу поддержки