Skip To Content

Utilitaire Publish Routing Services (Publier des services de calcul d’itinéraire)

L’utilitaire Publish Routing Services (Publier des services de calcul d’itinéraire) vous permet de publier des services d’itinéraires, de feuilles de route et logistiques en fonction d’un jeu de données réseau sur ArcGIS Server. Ces services permettent d’effectuer des analyses d’itinéraires, de ressources les plus proches, de zones de desserte, d’emplacements-allocations, de matrices de coût origine-destination ou de tournées de véhicules sur des réseaux de transport. Si votre instance ArcGIS Server est fédérée avec un portail, les services sont configurés en tant que services utilitaires avec votre portail. Une fois publiés, les services peuvent être utilisés avec des applications ArcGIS Desktop (par exemple, ArcGIS Pro et ArcMap) ou dans l’application Map Viewer disponible avec le portail ArcGIS Enterprise afin d’obtenir des itinéraires et d’effectuer des analyses. Les services sont similaires aux services d’itinéraires et de feuilles de route disponibles avec ArcGIS Online, mais reposent sur votre propre jeu de données réseau et s’exécutent sur votre instance ArcGIS Enterprise.

Licence :

Pour utiliser cet utilitaire, votre site ArcGIS Server doit disposer d’une licence Extension ArcGIS Network Analyst.

Conditions requises pour les données

Vous pouvez utiliser cet utilitaire avec un jeu de données réseau disponible dans le cadre de StreetMap Premium for ArcGIS ou avec votre propre jeu de données réseau. Avant d’exécuter l’utilitaire, le jeu de données réseau doit être copié (dans le même chemin d’accès au répertoire) vers toutes les machines participant au site de votre serveur SIG.

Astuce:

Bien que vous puissiez conserver le jeu de données réseau à un emplacement partagé accessible à toutes les machines du site de votre serveur SIG, il est recommandé de copier le jeu de données réseau localement sur chaque machine pour obtenir les meilleures performances lors de l’exécution des services.

Si vos données StreetMap Premium sont concédées sous licence, vous devez installer la licence de données appropriée sur chaque machine avant d’exécuter cet utilitaire. Suivez les instructions d’installation de la licence de données sous Linux ou Windows.

L’utilitaire prend en charge des jeux de données réseau issus de StreetMap Premium for ArcGIS 2015 version 1 ou ultérieure.

Héritage :

Les versions plus anciennes des jeux de données réseau Streetmap Premium (y compris les jeux de données réseau au format SDC) ne sont pas prises en charge.

Si vous utilisez votre propre jeu de données réseau, celui-ci doit remplir les conditions suivantes :

  • Il doit comporter au moins un attribut de coût basé sur le temps et un autre basé sur la distance.
  • Il définit au moins un mode de déplacement.
  • Il est stocké dans une géodatabase fichier.
  • Il prend en charge les feuilles de route.

Paramètres

Une fois que vous avez correctement configuré le jeu de données réseau sur le site de votre serveur SIG, vous pouvez exécuter l’utilitaire Publish Routing Services (Publier des services de calcul d’itinéraire) à l’aide des paramètres suivants.

ParamètreDétails

-u

Nom d’utilisateur d’un utilisateur doté de privilèges d’éditeur ou d’administrateur sur le site ArcGIS Server. Si le site est fédéré avec un portail, l’utilisateur doit être un utilisateur du portail et peut disposer d’un privilège d’administrateur ou d’un privilège d’éditeur permettant de publier des outils web et des couches basées sur un serveur. Si le site n’est pas fédéré, l’utilisateur doit disposer de privilèges d’administrateur. Si votre site est configuré avec l’authentification au niveau du web, spécifiez un utilisateur intégré, tel que le compte d’administrateur de site principal ou le compte d’administrateur initial sur votre portail.

-p

Le mot de passe de l'utilisateur a été spécifié avec le paramètre -u.

-s

Le nom de domaine complet de la machine exécutant ArcGIS Server, tel que gisserver.domain.com, ou l’URL locale de votre site ArcGIS Server au format https://gisserver.domain.com:6443/arcgis.

-P

Le nom de domaine complet de la machine, tel que gisportal.domain.com, où Portal, avec lequel votre site ArcGIS Server est fédéré, est installé. La valeur peut également être une URL locale du portail au format https://gisportal.domain.com:7443/arcgis Une valeur n’est requise pour cette option que si le serveur ArcGIS allant héberger les services de calcul d’itinéraire est fédéré avec le portail.

-n

Le chemin d’accès complet au jeu de données réseau. Outre le chemin d’accès à la géodatabase fichier, le chemin doit également inclure le nom du jeu de données réseau et le nom du jeu de données d’entité contenant le jeu de données réseau. Par exemple, cette option peut avoir pour valeur c:\data\Streets.gdb\Routing\Routing_ND sous Windows et /data/Streets.gdb\Routing\Routing_ND sous Linux, Streets.gdb étant la géodatabase fichier qui comporte un jeu de données réseau nommé Routing_ND dans un jeu de données d’entité nommé Routing.

-o

Chemin d’accès à un dossier où l’utilitaire créera les fichiers de définition de service des services et un fichier journal nommé publishroutingservices.log et incluant les détails sur l’exécution et toute erreur pouvant survenir.

-f

Le nom de dossier utilisé pour créer tous les services d’acheminement sur le site ArcGIS Server. La valeur par défaut est Acheminement.

-e

Le chemin d’accès complet jusqu’à l’étendue de la classe d’entités contenant l’étendue pour plusieurs jeux de données réseau. Cette option doit être spécifiée uniquement si vous publiez des services qui doivent utiliser plusieurs jeux de données réseau. Des détails supplémentaires sur la manière de configurer les services d’acheminement à l’aide de cette option peuvent être obtenus en contactant les services professionnels Esri.

-h

Imprime l'aide de l'utilitaire.

Exemples

L’exemple suivant indique comment appeler l’utilitaire Publish Routing Services (Publier des services de calcul d’itinéraire) sur un site ArcGIS Server fédéré avec un portail.

Publier des services de calcul d’itinéraire sur ArcGIS Server (Windows).

C:\Python27\ArcGISx6410.6\python.exe "C:\Program Files\ArcGIS\Server\tools\PublishRoutingServices\publishroutingservices.py" -s gisserver.domain.com -P gisportal.domain.com -u admin -p site.admin -o D:\RoutingServices\ServiceDefinitions -n D:\data\Streets.gdb\Routing\Routing_ND

Publier des services de calcul d’itinéraire sur ArcGIS Server (Linux). L’exemple suppose que l’emplacement d’installation de ArcGIS Server est /arcgis/server.

Remarque :

Contrairement à Windows, vous n’avez pas besoin de spécifier l’emplacement d’installation de Python lorsque vous exécutez l’utilitaire sous Linux.

/arcgis/server/tools/publishroutingservices/publishroutingservices -s gisserver.domain.com -P gisportal.domain.com -o /data/routing-services/service-definitions -n /data/Streets.gdb/Routing/Routing_ND
Transmettre les paramètres depuis un fichier

Vous pouvez appeler l’utilitaire en transmettant les paramètres depuis un fichier. Cela est utile si vous exécutez l’utilitaire dans le cadre d’un processus automatisé ou si vous ne souhaitez pas saisir toutes les options à la ligne de commande. Afin de préciser les paramètres depuis un fichier, créez un fichier texte, puis précisez chaque option sur une nouvelle ligne. Le nom de paramètre et la valeur doivent être séparés à l’aide d’un signe =. Un exemple de fichier avec différentes options est présenté ci-dessous.

-u=admin
-p=secret
-s=gisserver.domain.com
-P=gisportal.domain.com
-o=D:\RoutingServices\ServiceDefinitions
-n=D:\data\Streets.gdb\Routing\Routing_ND

Pour appeler l’outil avec le fichier tool-params.txt ci-dessus, appelez l’outil et précisez le chemin d’accès vers le fichier avec le symbole @.

Attention :

Veillez à ce que votre fichier contenant les paramètres n’ait pas de nouvelles lignes ou d’espaces blancs supplémentaires.

C:\Python27\ArcGISx6410.6\python.exe "C:\Program Files\ArcGIS\Server\tools\PublishRoutingServices\publishroutingservices.py" @D:\RoutingServices\tool-params.txt