--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/vrp/interface-import.md - https://yandex.kz/routing/doc/kk/vrp/interface-import.md - https://yandex.kz/routing/doc/ru/vrp/interface-import.md - https://yandex.kz/routing/doc/tr/vrp/interface-import.md - href: ru/vrp/interface-import.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 # Окно импорта ## Шаги работы {#import-steps} ### Шаг 1. Введите данные {#step-1} На вкладке **Планирование** выберите один из способов: - Нажмите кнопку **Загрузить файл** или перетащите документ в окно, чтобы загрузить предварительно подготовленные в Excel-файле данные. - Нажмите кнопку **Начать планирование** для внесения данных непосредственно на вкладках интерфейса. До того, как вы запустите планирование задачи, можно переключаться между вкладками и вносить изменения. ### Шаг 2. Исправьте ошибки и проверьте предупреждения {#step-2} Рядом с названиями вкладок отображаются значки статуса загруженной информации. Если система обнаружит ошибки в исходных данных, то отобразит их в перечне замечаний рядом с таблицей. Нажмите на сообщение в списке, чтобы подсветить проблемную ячейку. ![](./_images/ok-check.svg) — данные верны. ![](./_images/error.svg) — есть ошибки, которые необходимо исправить до начала планирования. ![](./_images/warn.svg) — есть предупреждения, но планировать можно. ### Шаг 3. Определите настройки оптимизации {#step-3} Выставите подходящие настройки для текущей задачи планирования. #| || **Название** | **Описание** || || **Часовой пояс** | Зона, для которой заданы все временные окна. || || **Способ передвижения** | Настройка по умолчанию для всех курьеров, у которых явно не задан [свой способ передвижения](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles.md#routing-mode). || || **Учитывать зоны** | При выборе значения **Да** заказы по координатам будут автоматически отнесены к нужным зонам из [Справочника геозон](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md), и при планировании будут учтены связанные с зонами [ограничения](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles.md#geozones). При выборе значения **Нет** зоны не учитываются. || || **Настройка качества решения** | Задает [качество решения](https://yandex.kz/routing/doc/ru/vrp/options-quality.md). Значение **Быстро** подходит для оперативной проверки результата на наличие ошибок, **Оптимально** — для полноценной маршрутизации. || |# ### Шаг 4. Запустите планирование {#step-4} На вкладке **Настройки** нажмите кнопку **Планировать**. Она активна, если в данных нет ошибок. Когда задача будет решена, откроется [результат планирования](https://yandex.kz/routing/doc/ru/vrp/interface-result.md). Его можно просмотреть и отредактировать. ## Управление в интерфейсе {#interface-managment} ### Добавление данных {#add} В списке **Скачать шаблон** вы найдете файлы с заполненными данными, которые можно использовать для тестового планирования (см. также раздел [Пример планирования](https://yandex.kz/routing/doc/ru/vrp/example.md)). Чтобы добавить данные: - Скопируйте данные из Excel, нажав кнопку **Загрузить файл**. - Распространите содержимое одной ячейки в диапазоне, растянув рамку выделения в пределах столбца. ### Редактирование данных {#edit} - Скорректируйте значения ячеек после двойного нажатия левой кнопкой мыши. - Удалите, вставьте, дублируйте строки с помощью контекстного меню, доступного по правой кнопке мыши на строке. ### Сортировка {#sort} Чтобы сортировать данные по столбцу: 1. Нажмите правой кнопкой мыши на любую ячейку и выберите **Сортировать столбец**. 1. Нажмите на заголовок столбца. ## Заполнение вкладок {#tabs} #| || **Вкладка** | **Пояснение** | **Видна по умолчанию** | **Инструкция для Excel** || || Заказы | Добавьте информацию о пунктах доставки, получения или точках старта/завершения маршрута. Обязательные поля: - Идентификатор заказа. - Адрес получателя или координаты. - Окно. | | [Лист Orders](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#orders) || || Склады | Добавьте информацию о месте нахождения и времени работы склада, особенностях начала и завершения маршрута. Обязательные поля: - Идентификатор склада. - Адрес склада или координаты. - Время работы склада. | | [Лист Depot](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#depot-depots) || || Карта | На вкладке расположена карта и список адресов доставки. Подробнее см. в разделе [Карта](https://yandex.kz/routing/doc/ru/vrp/interface-import.md#map). | | Нет, заполняется только в интерфейсе || || Транспорт | Добавьте информацию о служебных машинах, их габаритах и длительности рабочей смены. Чтобы использовать в планировании предварительно добавленные в [справочник](https://yandex.kz/routing/doc/ru/vrp/interface-transport.md) автомобили, отключите опцию **Транспорт из файла Excel**. Обязательное поле — идентификатор машины. | | [Лист Vehicles](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#vehicles) || || Несовместимое | Добавьте информацию о типах грузов и их несовместимости между собой. | | [Лист Incompatible order types](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#incompatible-order-types) || || Группы | Добавьте информацию о заказах, которые нужно доставить одним курьером. Обязательное поле — идентификаторы локаций. | | [Лист Location groups](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#location-groups) || || Доп. параметры | Заполните перечень опций маршрутизации. | | [Лист Options](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#options) || || Маршруты | Добавьте информацию о предопределенных маршрутах. Обязательные поля: - Идентификатор машины. - Порядковый номер смены. - Идентификатор локации. | | [Лист Routes](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md#routes) || || Настройки | Укажите дополнительные параметры маршрута: дата, часовой пояс, способ передвижения и др. Подробнее см. в разделе [Настройки](https://yandex.kz/routing/doc/ru/vrp/interface-import.md#step-3). | | Нет, заполняется только в интерфейсе || |# ### Карта {#map} На вкладке представлены: - карта; - список адресов заказов или складов; - ссылка для скачивания геокодированных данных в Excel. ![](./_images/planing-map-close.png) Здесь можно обработать адреса с помощью геокодера: для каждого определить широту и долготу. Геокодирование запускается автоматически и вручную. Геокодирование работает только для загрузки заказов и складов при помощи Excel-файлов. При обращении через API необходимо передавать данные не по адресам, а по координатам точек. Это значит, что геокодирование нужно сделать заранее на стороне интегрируемой системы. Есть два вида геокодирования: - [Автоматическое](#auto-geocoding) — по умолчанию, запускается после загрузки Excel-файла. - [Ручное](#manual-geocoding) — для самостоятельного назначения координат точке. #### Автоматическое геокодирование {#auto-geocoding} {% note alert %} Чтобы геокодирование запустилось, необходимо заполнить поле `address` (адрес получателя) для **каждого заказа** на листе `Orders`. {% endnote %} Автоматическое геокодирование начинает работать сразу после загрузки файла с данными в интерфейс. Но если в файле очень много адресов без координат, то для запуска может понадобиться нажать кнопку **Найти координаты**. Если в адресе получателя заказа указан номер квартиры, то автоматическое геокодирование определит координаты подъезда, к которому должен прибыть курьер. Данные о координатах подъездов пока есть не для всех адресов, но база постоянно пополняется. Получить более точные результаты помогает включение опции **Искать в видимой области карты**. Она будет полезна, если: - Адрес написан не полностью. Например, не указан город. - Нужно задать нестандартные границы поиска адресов. - Нужно разбить процесс геокодирования на несколько шагов, меняя область видимости на разных итерациях. **Как разбить геокодирование на шаги** 1. Остановите геокодирование кнопкой **Стоп**. 1. Включите опцию **Искать в видимой области карты**. 1. Переместите область видимости карты в нужную позицию. 1. Задайте масштаб. 1. Снова нажмите кнопку **Найти по адресу**. #### Результаты автоматического геокодирования {#auto-geocoding-result} После того как завершится геокодирование, слева от карты появятся группы адресов: **С координатами**, **Без координат**, **Приблизительно**. Групп может быть одна или несколько. Адреса распределяются по группам в зависимости от корректности исходных данных в загруженном файле. Все найденные адреса будут отмечены на карте цветными метками. #| || **Цвет метки** | **Группа** | **Признак** | **Пример** || || ![](./_images/geo-green.png) | С координатами | Адрес введен в корректном формате и без ошибок. | Москва, Пятницкое шоссе, 23к2 || || ![](./_images/geo-yellow.png) | Приблизительно | Адрес введен в некорректном формате. | 26Вс2, Москва, Большая Почтовая улица || || | | Адрес введен с ошибками или содержит информацию, не относящуюся к адресу. | Московская область, Бhgrrха, улица Терешковой, 13 || || | | Адрес без указания города (в разных городах могут быть одинаковые названия улиц). | Окружная улица, 8 || || | | Адрес в текстовом виде (поле `address`) и координаты (поля `point.lat` и `point.lon`) не соответствуют друг другу. | 22.0 и 33.1, Москва, Высоковольтный проезд, 1с36 || || | | Нужный дом не найден (но найден дом с номером, близким к запрошенному, или найдена только улица). | Москва, Большая Почтовая улица, 5559
или
Москва, Большая Почтовая улица, 55/59 || || ![](./_images/geo-red.png) | Без координат | Поле адрес не заполнено. | Пусто || || | | Улица не найдена, и возвращаются только координаты центра города. | Москва, улица Уличная, 8 || |# Адреса из группы **Приблизительно** нужно проверить на предмет правильности найденных координат в ручном режиме. Иногда также необходимо проверить адреса из группы **С координатами**. Например, может оказаться, что в поле с координатой точки есть опечатка. Тогда точка заказа будет позиционирована в тысячах километров от основной группы заказов. Чтобы найти такую ошибочную локацию, нужно сильно уменьшить масштаб карты. #### Особенности автоматического геокодирования {#auto-geocoding-specifics} Область поиска по умолчанию включает ± 1 градус от координат склада. Геокодер может неверно определить координаты заказа, если адрес задан неточно (например, без указания города), а в соседнем населенном пункте существует такая же улица и дом. Чтобы избежать этого, выбирайте масштаб и место на карте для отображения нужной точки. Параметры карты локально сохраняются для компании и используются при следующем планировании. Чтобы сделать геокодирование более точным, включите опцию **Искать в видимой области карты**. #### Ручное геокодирование {#manual-geocoding} Чтобы назначить координаты точке вручную: 1. Нажмите на адрес в списке рядом с картой. 2. На карте появится диалоговое окно и (для групп **Приблизительно** и **С координатами**) пин, отмечающий адрес заказа. Изменить адрес можно двумя способами: - **Диалоговое окно**. В появившемся диалоге начните вводить или изменять адрес, затем выберите подходящий вариант в выпадающем списке. - **Пин**. Захватите пин мышкой и перетащите по карте в нужное место. Адрес в диалоговом окне изменится. Используйте переключатель слоев, если нужно лучше разглядеть местность. ![](./_images/one-pin.png) 3. Пин и адрес в списке будут отмечены зеленым цветом. 4. Нажмите кнопку **Дальше** для перехода к следующему адресу из вашего списка. #### Сохранение результатов {#geocoding-save-results} Чтобы сохранить результат геокодирования в файл, нажмите **Скачать геокодированные адреса в Excel**. В скачанном файле для каждого адреса заказа будут указаны точные координаты по результатам автоматического и ручного геокодирования. Их можно использовать для дальнейшего планирования. Если в результате планирования есть заказы без координат, вы можете сохранить их и исключить из планирования. Для этого нажмите ![](./_images/download-result.png) → **Скачать заказы без координат и удалить их из планирования**. Написать в службу поддержки