--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/vrp/geozones.md - https://yandex.kz/routing/doc/kk/vrp/geozones.md - https://yandex.kz/routing/doc/ru/vrp/geozones.md - https://yandex.kz/routing/doc/tr/vrp/geozones.md - href: ru/vrp/geozones.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — геозоны --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt # Геозоны Геозоны позволяют задавать ограничения при планировании с учетом характеристик автомобилей, условий доступа и особенностей местности. Подробнее об этом см. в разделе [Транспортное средство](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles.md#geozones). При распределении заказов учитывается несовместимость геозон — как заданная [глобальной опцией](https://yandex.kz/routing/doc/ru/vrp/options-geozones.md#incompatible-zones), так и определенная для [отдельных курьеров](https://yandex.kz/routing/doc/ru/vrp/options-geozones.md#incompatible-zones). Также при планировании можно [отменить все ограничения](https://yandex.kz/routing/doc/ru/vrp/options-geozones.md#incompatible-zones), связанные с геозонами. Если заказы [связаны между собой](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#pickup-and-delivery) типами `pickup` и `delivery`, и один из заказов принадлежит к [геозоне](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md), то связанный с ним заказ также будет относиться к этой зоне. {% note info %} Вы можете добавить не больше 500 геозон для одной компании. {% endnote %} Чтобы отменить ограничения для одного или нескольких заказов в маршруте, используйте параметр `ignore_zones_compatibility`. Подробнее об этом см. в разделе [Несовместимость заказов с учетом геозон](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-incompatibility-zones). ## Геозоны в интерфейсе {#geozones-interface} Работать с геозонами из [cправочника](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md) можно через интерфейс Планирования. Для этого: 1. Определите геозоны в разделе **Справочники** → **Геозоны** (подробнее см. [Справочник геозон](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md)). 1. Спланируйте маршрут с помощью [Excel-файла](https://yandex.kz/routing/doc/ru/vrp/example.md). 1. На вкладке **Настройки** при [определении настроек оптимизации](https://yandex.kz/routing/doc/ru/vrp/interface-import.md#step-3) выберите **Учитывать геозоны** → **Да**. При планировании заказы по координатам будут автоматически отнесены к нужным зонам. Также можно использовать [публичные геозоны](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md#geozones-public): - `public_inside_ttk` — территория внутри ТТК; - `public_inside_mkad` — территория от МКАД до ТТК (не включает территорию внутри ТТК); - `public_inside_gr` — территория Садового кольца; - `public_ttk_gr` — территория ТТК без Садового кольца. ## Геозоны в API {#geozones-api} Работать с геозонами в API можно следующими способами: - С помощью [методов API](#geozones-methods-api). - Используя [геозоны из справочника](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md) и [публичные геозоны](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md#geozones-public). - Задавая [границы геозон с помощью координат](#geozones-zones) в задаче планирования. ### Методы API для работы с геозонами {#geozones-methods-api} [Методы API](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#tag/zones) удобно использовать в следующих ситуациях: - вы создаете и редактируете зоны в стороннем сервисе, актуализируете справочник геозон в Маршрутизации с помощью методов [добавления](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/addsCompanyZonesToReferenceBook), [изменения](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/patchesCompanyZoneFromReferenceBook) и [удаления](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/deletesCompanyZoneFromReferenceBook) геозон, а затем используете этот справочник для планирования; {% cut "Пример JSON" %} В примере задается геозона с названием `zone_1` и пустой областью внутри. Геозона будет окрашена в зеленый цвет при просмотре через интерфейс. ```json [ { "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)" } ] ``` {% endcut %} - вы создаете и редактируете геозоны в [интерфейсе Маршрутизации](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md), а затем загружаете их в свою корпоративную систему с помощью методов [Получить зону компании](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/getsCompanyZoneFromReferenceBook) или [Получить справочник зон компании](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/getsCompanyZonesFromReferenceBook). Также вы можете использовать методы [Получить публичную геозону](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/getsPublicZoneFromReferenceBook) и [Получить справочник публичных геозон](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/getsPublicZonesFromReferenceBook). Чтобы работать с геозонами с помощью API, отправьте запрос к ресурсу [mvrp с OAuth авторизацией](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#tag/mvrpaddsATask): ```bash curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST -d <тело запроса> https://courier.yandex.ru/api/v1/vrs/add/mvrp ``` В заголовке `Authorization: OAuth <ваш-токен>` вместо `<ваш-токен>` укажите [OAuth-токен](https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md), полученный для работы с Мониторингом. {% note alert %} Путь в запросе с авторизацией (с OAuth-токеном) отличается от пути, указанного в [спецификации](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/addMVRPTask) (с API-ключом). {% endnote %} ### Описание геозон с помощью координат {#geozones-zones} Чтобы задать координаты геозон непосредственно в задаче планирования, в запросе создайте объект `zones`. Каждый элемент этого объекта описывает одну зону и содержит координаты вершин многоугольника. Для получения координат воспользуйтесь инструментами [Конструктора карт Яндекса](https://yandex.ru/map-constructor/): 1. Нарисуйте зону при помощи инструмента **Многоугольники** (подробнее см. в разделе [Создание объекта](https://yandex.ru/support/maps-builder/concept/markers_1.html) Справки Конструктора карт). 1. Нажмите **Сохранить и продолжить** → **Экспорт** (подробнее см. в разделе [Экспорт объектов карты](https://yandex.ru/support/maps-builder/concept/markers_3.html) Справки Конструктора карт). 1. Выберите **GeoJSON** → **Скачать**. 1. Используйте объект `geometry` в запросе для формирования объекта `zones`. {% cut "Пример описания геозоны в запросе" %} ```json "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 ] ] ] } } ] ``` {% endcut %} Чтобы использовать описание геозон с помощью координат, отправьте запрос к ресурсу [mvrp](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/addMVRPTask): ```bash curl -H "Content-Type: application/json" -X POST -d <тело запроса> https://courier.yandex.ru/vrs/api/v1/add/mvrp?apikey= ``` Написать в службу поддержки