Геозоны

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

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

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

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

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

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

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

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

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

Геозоны в API

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

• С помощью методов API.
• Используя геозоны из справочника и публичные геозоны.
• Задавая границы геозон с помощью координат в задаче планирования.

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

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

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

• вы создаете и редактируете геозоны в интерфейсе Маршрутизации, а затем загружаете их в свою корпоративную систему с помощью методов Получить зону компании или Получить справочник зон компании. Также вы можете использовать методы Получить публичную геозону и Получить справочник публичных геозон.

Чтобы работать с геозонами с помощью 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-токен, полученный для работы с Мониторингом.

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

Чтобы задать координаты геозон непосредственно в задаче планирования, в запросе создайте объект 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-ключ>