L’utilitaire Publier des services de calcul d’itinéraire vous permet de publier des services de feuille de route, de calcul d’itinéraire et logistiques en fonction d’un jeu de données réseau sur votre site 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 le site ArcGIS Server est fédéré 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 dans des applications clientes telles que ArcGIS Pro ou Map Viewer Classic du portail ArcGIS Enterprise pour calculer une feuille de route et effectuer des analyses.
Les services sont similaires aux services de feuille de route et de calcul d’itinéraire disponibles avec ArcGIS Online, mais reposent sur votre propre jeu de données réseau et s’exécutent dans ArcGIS Enterprise.
Licence :
Pour utiliser cet utilitaire, votre site ArcGIS Server doit disposer d’une licence Extension ArcGIS Network Analyst .
Conseil :
Les services créés par cet utilitaire ont été significativement améliorés dans ArcGIS Server 10.8. Si vous mettez votre site existant à niveau ArcGIS Server à partir d’une version antérieure, il vous est recommandé de supprimer les services de calcul d’itinéraire existants créés par cet outil dans la version antérieure de votre site de serveur et de republier les services de calcul d’itinéraire à l’aide de la dernière version de l’outil.
Conditions requises pour les données
Vous pouvez utiliser cet utilitaire avec un jeu de données réseau disponible dans le cadre de ArcGIS StreetMap Premium ou avec votre propre jeu de données réseau stocké dans une géodatabase fichier, une géodatabase d’entreprise ou un paquetage de cartes mobiles. Avant d’exécuter l’utilitaire, vous devez copier le jeu de données réseau (dans le même chemin d’accès au répertoire) vers toutes les machines participant à votre site ArcGIS Server. Si votre jeu de données réseau est stocké dans une géodatabase d’entreprise, cette dernière doit être accessible par toutes les machines de votre site de serveur.
Conseil :
Bien que vous puissiez conserver les jeux de données réseau basés sur une géodatabase fichier ou sur un paquetage de cartes mobiles à un emplacement partagé accessible à toutes les machines du site de votre serveur, il vous 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 ArcGIS 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.
L’utilitaire prend en charge des jeux de données réseau issus de ArcGIS StreetMap Premium 2015 version 1 ou ultérieure.
Héritage :
Les versions plus récentes des jeux de données réseau ArcGIS 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 prend en charge les feuilles de route.
Si vous utilisez un jeu de données réseau à partir d’un paquetage de cartes mobiles tel que StreetMap Premium for ArcGIS, vous devez d’abord exécuter l’outil de géotraitement Extraire un paquetage pour extraire le contenu du paquetage de cartes mobiles vers un dossier local avant d’exécuter l’utilitaire Publier des services de calcul d’itinéraire.
Paramètres
Une fois que vous avez correctement configuré le jeu de données réseau sur votre site ArcGIS Server, vous pouvez exécuter l’utilitaire Publier des services de calcul d’itinéraire à l’aide des paramètres suivants :
| Paramètre | Dé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 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 site ArcGIS Server qui va 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. Si le jeu de données réseau se trouve dans une géodatabase fichier, la valeur de l’option -n doit inclure le chemin d’accès à la géodatabase fichier, le nom du jeu de données réseau et le nom du jeu de classes d’entités 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. Si le jeu de données réseau se trouve dans un paquetage de cartes mobiles, la valeur de l’option -n doit inclure le chemin d’accès à la base de données SQLite dans le dossier d’où le paquetage de cartes mobiles a été extrait, le nom du jeu de données réseau et le nom du jeu de classes d’entités contenant le jeu de données réseau. Par exemple, cette option peut avoir pour valeur c:\street_data\p14\northamerica.geodatabase\Routing\Routing_ND sous Windows et /data/street_data/p14/northamerica.geodatabase/Routing/Routing_ND sous Linux, northamerica.geodatabase étant la géodatabase SQLite qui comporte un jeu de données réseau nommé Tournée_ND dans un jeu de classes d’entités nommé Tournée. Si le jeu de données réseau se trouve dans une géodatabase d’entreprise, la valeur de l’option -n doit inclure le chemin d’accès au fichier de connexions aux bases de données, le nom du jeu de données réseau et le nom du jeu de classes d’entités contenant le jeu de données réseau. Par exemple, cette option peut avoir pour valeur c:\street_data\egdb.sde\Routing\Routing_ND sous Windows et /street_data/egdb.sde/Routing/Routing_ND sous Linux, egdb.sde étant le fichier de connexions de la géodatabase d’entreprise qui comporte un jeu de données réseau nommé Tournée_ND dans un jeu de classes d’entités nommé Tournée. |
-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 de calcul d’itinéraire 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. |
-S | La liste des solveurs à inclure dans les services. Les choix valides sont Route, ClosestFacility, ServiceArea, OriginDestinationCostMatrix, Location-Allocation et VehicleRoutingProblem. La valeur de cette option est spécifiée sous la forme d’une liste de choix valides séparés par des virgules. Les valeurs disponibles sont sensibles à la casse. La valeur par défaut consiste à créer des services pour tous les solveurs. |
-c | Le chemin d’accès complet incluant le nom du fichier qui contient une configuration supplémentaire pour les services. Vous pouvez utiliser ce fichier de configuration afin de spécifier certaines propriétés pour les services de calcul d’itinéraire, telles que le nombre minimal et maximal d’instances de service. Le dossier framework/runtime/ArcGIS/Resources/ArcToolBox/Services/routingservices dans le répertoire d’installation de ArcGIS Server inclut deux fichiers de configuration d’échantillon, publishroutingservices.json et publishroutingservices_dedicated.json, qui présentent tous les paramètres pris en charge. L’outil utilise le fichier publishroutingservices.json par défaut. |
-d | Spécifier cette option a pour effet de créer un service dédié pour chaque solveur. Il s’agit d’une option avancée. Lorsque cette option est spécifiée, votre site ArcGIS Server utilise beaucoup plus de ressources informatiques et de mémoire. Cette option n’est recommandée que pour les sites ArcGIS Server spécialisés. Lorsque cette option est utilisée, l’option -c doit spécifier un fichier de configuration similaire au fichier publishroutingservices_dedicated.json. |
-h | Imprime l'aide de l'utilitaire. |
Exemples
Les exemples suivants indiquent comment appeler l’utilitaire Publier des services de calcul d’itinéraire sur un site ArcGIS Server fédéré avec un portail.
Attention :
Si la valeur d’un des paramètres pris en charge par l’utilitaire utilise le caractère @, vous ne pouvez pas spécifier les valeurs des paramètres sur la ligne de commande. Vous devez en revanche enregistrer les paramètres dans un fichier et les transmettre à partir du fichier.
Publier des services de calcul d’itinéraire sur ArcGIS Server. L’exemple suppose que l’emplacement d’installation d’ArcGIS Server est /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_NDVous 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. Pour spécifier les paramètres depuis un fichier, créez un fichier texte, puis précisez chaque option sur une nouvelle ligne. Le nom et la valeur du paramètre doivent être séparés avec le 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=/data/routing-services/service-definitions
-n=/data/Streets.gdb/Routing/Routing_NDPour 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.
/arcgis/server/tools/publishroutingservices/publishroutingservices @/data/tool-params.txtVous avez un commentaire à formuler concernant cette rubrique ?