Геозоны

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

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

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

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

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

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

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

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

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

Геозоны в API

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

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

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