Skip To Content

Утилита Опубликовать сервисы маршрутов

Утилита Опубликовать сервисы маршрутов позволяет выполнить публикацию на сайте ArcGIS Server сервисов направлений, маршрутов и логистики. Эти сервисы могут использоваться для выполнения анализа таких проблем в транспортных сетях, как ближайшие пункты обслуживания, область обслуживания, Размещение-Распределение, матрицы пункт отправления – пункт назначения, а также выбор маршрута транспорта.

Если сайт ArcGIS Server интегрирован с порталом, то эти сервисы настраиваются как служебные сервисы с порталом. После публикации эти сервисы могут использоваться в таких клиентских приложениях, как ArcGIS Pro или в приложении Map Viewer Classic, которое доступно на портале ArcGIS Enterprise и позволяет построить путевой лист и выполнить анализ.

Эти сервисы аналогичны сервисам направлений и маршрутов, которые доступны на ArcGIS Online, но построены на собственном наборе сетевых данных и работают на ArcGIS Enterprise.

Лицензия:

Для использования этой утилиты сайту ArcGIS Server необходима Расширение ArcGIS Network Analyst.

Подсказка:

Сервисы, созданные этой утилитой, значительно улучшены в ArcGIS Server 10.8. Если вы обновляете сайт ArcGIS Server с одной из предыдущих версий, рекомендуется удалить имеющиеся сервисы маршрутизации, созданные в предыдущей версии сайта сервера и снова опубликовать их, используя последнюю версию инструмента.

Требования к данным

Вы можете использовать эту утилиту с набором сетевых данных, который доступен как часть ArcGIS StreetMap Premium или со своим собственным набором сетевых данных, хранящимся в файловой базе геоданных, многопользовательской базе геоданных или в пакете мобильных карт. Перед запуском этой утилиты необходимо перенести копии набора сетевых данных на все компьютеры, которые участвуют в сайте ArcGIS Server (указав такой же путь к директории). Если набор сетевых данных хранится в многопользовательской базе геоданных, она должны быть доступна для всех компьютеров сайта сервера.

Подсказка:

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

Если ваши данные ArcGIS StreetMap Premium лицензированы, на всех компьютерах перед запуском этой утилиты необходимо установить соответствующую лицензию. Следуйте инструкции по установке лицензии данных на компьютерах с Linux или .

Эта утилита поддерживает наборы сетевых данных, начиная с версии ArcGIS StreetMap Premium 2015 версия 1 и выше.

Прежние версии:

Более ранние версии наборов сетевых данных ArcGIS StreetMap Premium (включая наборы сетевых данных в формате SDC) не поддерживаются.

Собственные наборы сетевых данных должны отвечать следующим условиям:

  • Должны иметь не менее одного атрибута стоимости на основе времени и не менее одного – на основе расстояния
  • Должны иметь не менее одного режима перемещения
  • Должны поддерживать направления

Если вы используете набор сетевых данных из пакета мобильных карт, такого как пакет StreetMap Premium for ArcGIS, следует сначала запустить инструмент геообработки Извлечь пакет, чтобы извлечь содержимое пакета мобильной карты в локальную папку перед запуском утилиты Опубликовать сервисы маршрутов.

Параметры

После корректной установки набора сетевых данных на сайте ArcGIS Server вы можете запустить утилиту Опубликовать сервисы маршрутов, используя следующие параметры.

ПараметрПодробная информация

-u

Имя пользователя для пользователя с правами доступа издателя или администратора на сайте ArcGIS Server. Если сайт интегрирован с порталом, этот пользователь должен быть пользователем портала и может быть наделен правами доступа администратора или издателя, что дает ему возможность публикации веб-инструментов и слоев на основе данных сервера. Если сайт не интегрирован, то пользователь должен иметь права доступа администратора. Если сайт настроен с аутентификацией веб-уровня, укажите встроенного пользователя, например, учетную запись основного администратора сайта или первичную учетную запись администратора на портале.

-p

Пароль пользователя, указанного с параметром -u.

-s

Полное доменное имя компьютера с ArcGIS Server, например – gisserver.domain.com или локальный URL сайта ArcGIS Server в формате https://gisserver.domain.com:6443/arcgis.

-P

Полное доменное имя компьютера, например – gisportal.domain.com, где установлен Portal, с которым интегрирован сайт ArcGIS Server. Таким значением может быть также локальный URL портала в формате https://gisportal.domain.com:7443/arcgis Значение для этой опции необходимо только в случае, если сайт ArcGIS Server, на котором будут размещены сервисы маршрутов, интегрирован с порталом.

-n

Полный путь к набору сетевых данных.

Если набор сетевых данных находится в файловой базе геоданных, значение опции -n должно включать путь к файловой базе геоданных,имя набора сетевых данных и имя набора классов объектов, содержащего набор сетевых данных. Например, для варианта c:\data\Streets.gdb\Routing\Routing_ND на Windows и /data/Streets.gdb/Routing/Routing_ND на Linux Streets.gdb является файловой базой геоданных с набором сетевых данных под именем Routing_ND в наборе классов объектов с именем Routing.

Если набор сетевых данных находится в пакете мобильных карт, значение опции -n должно включать путь к базе данных SQLite,имя набора сетевых данных и имя набора классов объектов, содержащего набор сетевых данных. Например, для этой опции может быть указано значение c:\street_data\p14\northamerica.geodatabase\Routing\Routing_ND на Windows и /data/street_data/p14/northamerica.geodatabase/Routing/Routing_ND на Linux, где northamerica.geodatabase является базой данных SQLite с набором сетевых данных под именем Routing_ND в наборе классов объектов Routing.

Если набор сетевых данных находится в многопользовательской базе геоданных, значение опции -n должно включать путь к файлу подключения базы данных, имя набора сетевых данных и имя набора классов объектов, содержащего набор сетевых данных. Например, c:\street_data\egdb.sde\Routing\Routing_ND на Windows или /street_data/egdb.sde/Routing/Routing_ND на Linux, где egdb.sde является именем файла подключения многопользовательской базы, содержащей набор сетевых данных Routing_ND в наборе классов объектов с именем Routing.

-o

Путь к папке, в которой эта утилита создаст файлы определения сервиса для сервисов и файл журнала с именем publishroutingservices.log, включающий подробную информацию о ходе выполнения, а также о возможных ошибках.

-f

Имя папки, используемой для создания всех сервисов маршрутов сайта ArcGIS Server. Имя по умолчанию Routing.

-e

Полный путь к классу объектов экстентов с экстентами нескольких наборов сетевых данных. Эту опцию требуется задать, только если вы публикуете сервисы, для которых нужно использовать несколько наборов сетевых данных. Подробности настройки сервисов маршрутов с этой опцией содержатся в Esri Professional Services.

-S

Список механизмов расчета, которые будут включены в сервис. Возможны такие варианты: Route, ClosestFacility, ServiceArea, OriginDestinationCostMatrix, Location-Allocation и VehicleRoutingProblem. Значение этой опции задается в виде списка значений, разделенных запятой. Значения чувствительны к регистру. По умолчанию создается сервис со всеми механизмами расчета.

-c

Полный путь включает имя файла, содержащего дополнительные настройки сервиса.

Вы можете использовать этот файл конфигурации для задания некоторых свойств сервиса маршрутизации, таких как минимальное и максимальное число экземпляров сервиса. Папка framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices в папке установки ArcGIS Server включает два примера файлов конфигурации, publishroutingservices.json и publishroutingservices_dedicated.json, которые показывают все поддерживаемые настройки. По умолчанию инструмент использует файл publishroutingservices.json.

-d

Задание этой опции позволяет создавать выделенный сервис для каждого механизма решения. Это расширенная опция. При задании этой опции, сайт ArcGIS Server будет использовать значительно больше вычислительных ресурсов и памяти. Эта опция рекомендуется только для специализированных сайтов ArcGIS Server.

При использовании этой опции, опция -c должна задавать файл конфигурации, похожий на файл publishroutingservices_dedicated.json.

-h

Вывод справки по утилите.

Примеры

В приведенных ниже примерах показывается, как можно вызвать утилиту Опубликовать сервисы маршрутов на сайте ArcGIS Server, интегрированном с порталом.

Внимание:

Если значение для любого параметра, поддерживаемого утилитой, использует символ @, вы не сможете указать значения параметров в командной строке. Вместо этого вы должны сохранить параметры в файле и передать параметры из этого файла.

Публикация сервисов маршрутов на ArcGIS Server. В приведенном примере подразумевается, что ArcGIS Server установлен в /arcgis/server.

/arcgis/server/tools/publishroutingservices/publishroutingservices -s gisserver.domain.com -P gisportal.domain.com -u admin -p secret -o /data/routing-services/service-definitions -n /data/Streets.gdb/Routing/Routing_ND
Получение параметров из файла

Вы можете вызвать утилиту, передав параметры из файла. Это полезно, когда вы выполняете утилиту, как часть автоматизированного процесса либо не хотите водить все опции в командную строку. Для получения параметров из файла создайте текстовый файл и указывайте каждую опцию в новой строке. Имя и значение параметра разделяются символом =. Простой файл с опциями представлен ниже.


-u=admin
-p=secret
-s=gisserver.domain.com
-P=gisportal.domain.com
-o=/data/routing-services/service-definitions
-n=/data/Streets.gdb/Routing/Routing_ND

Для запуска инструмента с указанным выше файлом tool-params.txt запустите инструмент и укажите путь к файлу с символом @.

Внимание:

Убедитесь, что ваш файл с параметрами не содержит пустых линий и пробелов.

/arcgis/server/tools/publishroutingservices/publishroutingservices @/data/tool-params.txt