Skip to main content

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

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

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

Эти сервисы аналогичны сервисам путевых листов и маршрутов, которые доступны на 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 лицензированы, на всех компьютерах перед запуском этой утилиты необходимо установить соответствующую лицензию. Следуйте инструкции по установке лицензии данных на Windows.

Утилита поддерживает наборы сетевых данных из ArcGIS StreetMap Premium 2015 Release 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

Полное доменное имя компьютера портала, с которым интегрирован ваш сайт ArcGIS Server, например, gisportal.example.com. Таким значением может быть также локальный 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, LastMileDelivery и SnapToRoads. Значение этой опции задается в виде списка значений, разделенных запятой. Значения чувствительны к регистру. По умолчанию создается сервис со всеми механизмами расчета.

-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.example.com -P gisportal.example.com -u admin -p secret -o /data/routing-services/service-definitions -n /data/Streets.gdb/Routing/Routing_ND

Публикация сервисов маршрутов на ArcGIS Server. В приведенном примере подразумевается, что ArcGIS Server установлен в C:\Program Files\ArcGIS\Server.

"C:\Program Files\ArcGIS\Server\tools\PublishRoutingServices\publishroutingservices.bat" -s gisserver.example.com -P gisportal.example.com -u admin -p secret -o D:\RoutingServices\ServiceDefinitions -n D:\data\Streets.gdb\Routing\Routing_ND

Получение параметров из файла

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

-u=admin
-p=secret
-s=gisserver.example.com
-P=gisportal.example.com
-o=/data/routing-services/service-definitions
-n=/data/Streets.gdb/Routing/Routing_ND
-u=admin
-p=secret
-s=gisserver.example.com
-P=gisportal.example.com
-o=D:\RoutingServices\ServiceDefinitions
-n=D:\data\Streets.gdb\Routing\Routing_ND

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

Внимание:

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

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

"C:\Program Files\ArcGIS\Server\tools\PublishRoutingServices\publishroutingservices.bat" @D:\RoutingServices\tool-params.txt