Dienstprogramm zum Veröffentlichen von Routing-Services
Das Dienstprogramm zum Veröffentlichen von Routing-Services ermöglicht Ihnen das Veröffentlichen von Wegbeschreibungs-, Routing- und Logistik-Services in einem Netzwerk-Dataset Ihrer ArcGIS-Server-Site. Mit diesen Services können Routen, nächstgelegene Einrichtungen, Einzugsgebiete, Location-Allocations, Start-Ziel-Kostenmatrizen und Vehicle Routing Problems in Verkehrsnetzwerken analysiert werden.
Wenn die ArcGIS-Server-Site verbunden ist, werden die Services als Utility-Services für die Organisation konfiguriert. Nach der Veröffentlichung können Sie die Services mit Client-Anwendungen wie ArcGIS Pro oder dem Map Viewer verwenden, um Wegbeschreibungen abzurufen und Analysen auszuführen.
Die Services ähneln den Wegbeschreibungs- und Routing-Services, die in ArcGIS Online verfügbar sind. Sie basieren jedoch auf Ihrem eigenen Netzwerk-Dataset und werden in ArcGIS Enterprise ausgeführt.
Lizenz:
Um dieses Dienstprogramm zu nutzen, muss Ihre ArcGIS-Server-Site eine Lizenz für die Erweiteurng "ArcGIS Network Analyst" besitzen.
Tipp:
Die mit diesem Dienstprogramm erstellten Services wurden in ArcGIS Server 10.8 deutlich verbessert. Wenn Sie ein Upgrade von früheren Versionen der ArcGIS-Server-Site durchführen, empfiehlt es sich, alle vorhandenen Routing-Services, die in der früheren Version der Server-Site mit diesem Werkzeug erstellt wurden, zu löschen und mit der aktuellen Version des Werkzeugs neu zu veröffentlichen.
Datenanforderungen
Sie können dieses Dienstprogramm mit einem Netzwerk-Dataset verwenden, das im Rahmen von ArcGIS StreetMap Premium verfügbar ist, oder mit einem eigenen, in einer File-Geodatabase, einer Enterprise-Geodatabase oder einem mobilen Kartenpaket gespeicherten Netzwerk-Dataset. Vor dem Ausführen des Dienstprogramms sollte das Netzwerk-Dataset auf alle Computer der ArcGIS-Server-Site kopiert werden (in denselben Verzeichnispfad). Ist Ihr Netzwerk-Dataset in einer Enterprise-Geodatabase gespeichert, müssen alle Computer Ihrer Server-Site auf die Enterprise-Geodatabase zugreifen können.
Tipp:
Sie können Netzwerk-Datasets, die auf einer File-Geodatabase oder einem mobilen Kartenpaket basieren, zwar an einem freigegebenen Speicherort bereitstellen, auf den alle Computer der Server-Site zugreifen können, aber es empfiehlt sich, das Netzwerk-Dataset lokal auf jeden Computer zu kopieren, um beim Ausführen der Services eine optimale Leistung zu erzielen.
Wenn die ArcGIS StreetMap Premium-Daten lizenziert sind, müssen Sie auf jedem Computer die entsprechende Datenlizenz installieren, bevor Sie dieses Dienstprogramm ausführen. Folgen Sie den Anweisungen zum Installieren der Datenlizenz unter Linux.
Wenn die ArcGIS StreetMap Premium-Daten lizenziert sind, müssen Sie auf jedem Computer die entsprechende Datenlizenz installieren, bevor Sie dieses Dienstprogramm ausführen. Folgen Sie den Anweisungen zum Installieren der Datenlizenz unter Windows.
Das Dienstprogramm unterstützt Netzwerk-Datasets ab ArcGIS StreetMap Premium 2015, Version 1.
Legacy:
Frühere Versionen von ArcGIS StreetMap Premium-Netzwerk-Datasets (einschließlich der Netzwerk-Datasets im SDC-Format) werden nicht unterstützt.
Wenn Sie ein eigenes Netzwerk-Dataset verwenden, muss dieses die folgenden Bedingungen erfüllen:
Es verfügt über mindestens ein zeitbasiertes und ein entfernungsbasiertes Kostenattribut.
Es definiert mindestens einen Reisemodus.
Es unterstützt Wegbeschreibungen.
Wenn Sie ein Netzwerk-Dataset aus einem mobilen Kartenpaket, z. B. einem der mobilen Kartenpakete von StreetMap Premium for ArcGIS verwenden, sollten Sie zunächst das Geoverarbeitungswerkzeug Paket extrahieren ausführen, um den Inhalt des mobilen Kartenpakets in einen lokalen Ordner zu extrahieren, bevor Sie das Dienstprogramm zum Veröffentlichen von Routing-Services ausführen.
Parameter
Nachdem Sie das Netzwerk-Dataset ordnungsgemäß in der ArcGIS-Server-Site eingerichtet haben, können Sie das Dienstprogramm zum Veröffentlichen von Routing-Services unter Verwendung der folgenden Parameter ausführen:
|
Parameter |
Details |
|---|---|
|
-u |
Der Benutzername für einen Benutzer mit Publisher- oder Administratorberechtigungen in der ArcGIS-Server-Site. Wenn die Site verbunden ist, muss der Benutzer ein Organisationsmitglied mit Administrator- oder Publisher-Berechtigungen sein, die das Veröffentlichen von Web-Werkzeugen und serverbasierten Layern zulassen. Wenn die Site nicht verbunden ist, muss der Benutzer über Administratorberechtigungen verfügen. Wenn die Site mit Authentifizierung auf Webebene konfiguriert ist, geben Sie einen integrierten Benutzer an, z. B. das primäre Site-Administratorkonto oder das initiale Administratorkonto in Ihrer Organisation. |
|
-p |
Das Kennwort des Benutzers, der mit dem "-u"-Parameter angegeben wird. |
|
-s |
Der vollständig qualifizierte Domänenname des Computers, auf dem ArcGIS Server ausgeführt wird, z. B. gisserver.domain.com, oder die lokale URL der ArcGIS-Server-Site im Format https://gisserver.domain.com:6443/arcgis. |
|
-P |
Der vollständig qualifizierte Domänenname des Computers, mit dem die ArcGIS-Server-Site verbunden ist, z. B. gisportal.example.com. Der Wert kann auch eine lokale URL des Portals im Format https://gisportal.example.com:7443/arcgis sein. Ein Wert für diese Option ist nur erforderlich, wenn die ArcGIS-Server-Site, die die Routing-Services hostet, verbunden ist. |
|
-n |
Der vollständige Pfad zum Netzwerk-Dataset. Ist das Netzwerk-Dataset in einer File-Geodatabase, sollte der Wert für die Option Ist das Netzwerk-Dataset in einem mobilen Kartenpaket, sollte der Wert für die Option Ist das Netzwerk-Dataset in einer Enterprise-Geodatabase, sollte der Wert für die Option |
|
-o |
Der Pfad zu einem Ordner, in dem das Dienstprogramm die Service-Definitionsdateien für die Services und eine Protokolldatei mit dem Namen publishroutingservices.log erstellt. Die Protokolldatei enthält die Informationen über die Operation sowie ggf. aufgetretene Fehler. |
|
-f |
Der für die Erstellung aller Routing-Services der ArcGIS-Server-Site verwendete Dateiname. Der Standardwert ist Routing. |
|
-e |
Der vollständige Pfad zur Ausdehnungs-Feature-Class, der die Ausdehnungen für mehrere Netzwerk-Datasets enthält. Diese Option sollte nur angegeben werden, wenn Sie Services veröffentlichen, die mehrere Netzwerk-Datasets verwenden. Weitere Informationen zum Einrichten von Routing-Services mit dieser Option erhalten Sie bei Esri Professional Services. |
|
-S |
Die Liste der Solver, die in die Services aufgenommen werden sollen. Gültige Auswahloptionen sind Route, ClosestFacility, ServiceArea, OriginDestinationCostMatrix, Location-Allocation, VehicleRoutingProblem, LastMileDelivery und SnapToRoads. Der Wert für diese Option wird als kommagetrennte Liste der gültigen Auswahloptionen angegeben. Bei den Auswahlwerten muss die Groß-/Kleinschreibung beachtet werden. Der Standardwert bewirkt, dass Services für alle Solver erstellt werden. |
|
-c |
Der vollständige Pfad einschließlich des Namens der Datei, die die zusätzliche Konfiguration für die Services enthält. Mit dieser Konfigurationsdatei können Sie bestimmte Eigenschaften für die Routing-Services festlegen, z. B. die minimale und maximale Anzahl von Service-Instanzen. Der Ordner |
|
-d |
Die Angabe dieser Option bewirkt, dass für jeden Solver ein eigener Service erstellt wird. Es handelt sich hierbei um eine erweiterte Option. Wenn Sie diese Option angeben, benötigt Ihre ArcGIS-Server-Site erheblich mehr Rechen- und Speicherressourcen. Diese Option wird nur für spezialisierte ArcGIS-Server-Sites empfohlen. Bei Verwendung dieser Option sollte für die Option |
|
-h |
Druckt die Hilfe für das Dienstprogramm. |
Beispiele
In den folgenden Beispielen wird gezeigt, wie das Dienstprogramm zum Veröffentlichen von Routing-Services in einer ArcGIS-Server-Site aufgerufen wird, die verbunden ist.
Achtung:
Wenn der Wert eines vom Dienstprogramm unterstützten Parameters das Zeichen @ enthält, können Sie die Parameterwerte nicht über die Befehlszeile eingeben. Speichern Sie die Parameter in diesem Fall in einer Datei, und übergeben Sie sie aus dieser Datei.
Veröffentlichen von Routing-Services in ArcGIS-Server. Im Beispiel wird vorausgesetzt, dass das Installationsverzeichnis von ArcGIS Server /arcgis/server lautet.
/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
Veröffentlichen von Routing-Services in ArcGIS-Server. Im Beispiel wird vorausgesetzt, dass das Installationsverzeichnis von ArcGIS Server C:\Program Files\ArcGIS\Server lautet.
"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
Übergeben von Parametern aus einer Datei
Sie können das Dienstprogramm aufrufen, indem Sie einen Parameter aus einer Datei übergeben. Das ist hilfreich, wenn Sie das Dienstprogramm im Rahmen eines automatisierten Prozesses ausführen oder nicht alle Optionen an der Befehlszeile eingeben möchten. Erstellen Sie zum Übergeben von Parametern aus einer Datei eine Textdatei, und geben Sie die einzelnen Optionen jeweils in einer neuen Zeile an. Parametername und -wert müssen durch das Zeichen = getrennt werden. Nachstehend finden Sie eine Beispieldatei mit verschiedenen Optionen.
-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
Wenn Sie das Werkzeug mit der oben genannten Datei tool-params.txt aufrufen möchten, öffnen Sie das Werkzeug, und geben Sie den Dateipfad mit dem Symbol @ an.
Achtung:
Vergewissern Sie sich, dass die Datei mit den Parametern keine Leerzeilen oder Leerzeichen enthält.
/arcgis/server/tools/publishroutingservices/publishroutingservices @/data/tool-params.txt
"C:\Program Files\ArcGIS\Server\tools\PublishRoutingServices\publishroutingservices.bat" @D:\RoutingServices\tool-params.txt