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 mit einem Portal verbunden ist, sind die Services als Utility-Services für das Portal konfiguriert. Nach der Veröffentlichung können Sie die Services mit Client-Anwendungen, z. B. ArcGIS Pro oder im Map Viewer Classic des ArcGIS Enterprise-Portals 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:

Zum Verwenden dieses Dienstprogramms erfordert Ihre ArcGIS Server-Site eine Lizenz für die ArcGIS Network Analyst extension.

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 Tool 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.

Das Dienstprogramm unterstützt Netzwerk-Datasets ab ArcGIS StreetMap Premium 2015, Version 1.

Vorversion:

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 mit einem Portal verbunden ist, muss der Benutzer ein Portalbenutzer sein, und er kann über eine Administratorberechtigung oder Publisher-Berechtigung verfügen, die das Veröffentlichen von Web-Werkzeugen und serverbasierten Layern zulässt. 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 im Portal.
-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, auf dem die Instanz von Portal, in die die ArcGIS Server-Site eingebunden ist, installiert ist, z. B. gisserver.domain.com. Der Wert kann auch eine lokale URL des Portals im Format https://gisportal.domain.com:7443/arcgis sein. Ein Wert für diese Option ist nur erforderlich, wenn die ArcGIS Server-Site, die die Routing-Services hostet, mit dem Portal 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 -n den Pfad zur File-Geodatabase, den Namen des Netzwerk-Datasets sowie den Namen des Feature-Datasets enthalten, in dem sich das Netzwerk-Dataset befindet. Ein Wert für diese Option kann beispielsweise unter Windows c:\data\Streets.gdb\Routing\Routing_ND und unter Linux /data/Streets.gdb/Routing/Routing_ND lauten. Dabei ist Streets.gdb die File-Geodatabase, die über das Netzwerk-Dataset Routing_ND im Feature-Dataset Routing verfügt. Ist das Netzwerk-Dataset in einem mobilen Kartenpaket, sollte der Wert für die Option -n den Pfad zur SQLite-Datenbank aus dem Ordner, in dem das mobile Kartenpaket extrahiert wurde, den Namen des Netzwerk-Datasets sowie den Namen des Feature-Datasets enthalten, in dem sich das Netzwerk-Dataset befindet. Ein Wert für diese Option kann beispielsweise unter Windows C:\street_data\p14\northamerica.geodatabase\Routing\Routing_ND und unter Linux /data/street_data/p14/northamerica.geodatabase/Routing/Routing_ND lauten. Dabei ist northamerica.geodatabase die SQLite-Geodatabase, die über das Netzwerk-Dataset Routing_ND im Feature-Dataset Routing verfügt. Ist das Netzwerk-Dataset in einer Enterprise-Geodatabase, sollte der Wert für die Option -n den Pfad zur Datenbankverbindungsdatei, den Namen des Netzwerk-Datasets sowie den Namen des Feature-Datasets enthalten, in dem sich das Netzwerk-Dataset befindet. Ein Wert für diese Option kann beispielsweise unter Windows c:\street_data\egdb.sde\Routing\Routing_ND und unter Linux /street_data/egdb.sde/Routing/Routing_ND lauten. Dabei ist egdb.sde die Verbindungsdatei für die Enterprise-Geodatabase, die über das Netzwerk-Dataset Routing_ND im Feature-Dataset Routing verfügt.
-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 Ausführung 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 und VehicleRoutingProblem. 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 framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices im Installationsverzeichnis von ArcGIS Server enthält zwei Beispielkonfigurationsdateien, publishroutingservices.json und publishroutingservices_dedicated.json, die alle unterstützten Einstellungen anzeigen. Standardmäßig verwendet das Werkzeug die Datei publishroutingservices.json.
-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 -c eine Konfigurationsdatei angegeben werden, die der Datei publishroutingservices_dedicated.json ähnelt.
-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 mit einem Portal verbunden ist.

Vorsicht:

Wenn der Wert eines vom Dienstprogramm unterstützten Parameters das Zeichen @ enthält, können Sie über die Befehlszeile keine Parameterwerte 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.domain.com -P gisportal.domain.com -u admin -p secret -o /data/routing-services/service-definitions -n /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.domain.com
-P=gisportal.domain.com
-o=/data/routing-services/service-definitions
-n=/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.

Vorsicht:

Vergewissern Sie sich, dass die Datei mit den Parametern keine Leerzeilen oder Leerzeichen enthält.

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