Haut

Publier des services de calcul d’itinéraire

Dans cette rubrique

  1. Exemple de processus

Vous pouvez publier des services de calcul d’itinéraire sur ArcGIS Enterprise on Kubernetes en utilisant un jeu de données réseau qui modélise vos données de rue. Une fois publiés, les services de calcul d’itinéraire peuvent être exploités dans diverses applications telles que ArcGIS Pro ou permettre de calculer une feuille de route et d’effectuer des analyses dans Map Viewer Classic. Vous pouvez également concevoir des applications avec les API Web ArcGIS et les SDK runtime qui utilisent ces services de calcul d’itinéraire.

Pour publier des services de calcul d’itinéraire, vous devez exécuter l’outil Web Publier des services de calcul d’itinéraire qui fait partie du service de géotraitement PublishingTools figurant dans ArcGIS Enterprise on Kubernetes. L’outil crée tous les services de calcul d’itinéraire en fonction de votre jeu de données réseau et les inscrit en tant que services utilitaires sur votre portail d’entreprise de sorte que différentes applications explorent et utilisent ces services de calcul d’itinéraire.

Avant d’exécuter l’outil Web, assurez-vous que le jeu de données réseau utilisé pour publier les services de calcul d’itinéraire est accessible à tous les nœuds du déploiement. Pour ce faire, stockez la géodatabase fichier ou la géodatabase mobile contenant le jeu de données réseau dans un dossier inscrit en tant que data store de dossier pour votre déploiement ou ajoutez un élément de data store de base de données pour la géodatabase d’entreprise abritant le jeu de données réseau. Vous avez également besoin d’obtenir un jeton pour un utilisateur doté de privilèges administratifs qui soit valable pendant au moins 60 minutes.

Exemple de processus

Cette section décrit la procédure pour publier des services de calcul d’itinéraire à l’aide d’un jeu de données réseau dans une géodatabase fichier. Les étapes font référence à des URL et chemins d’accès aux données spécifiques qui diffèrent de ceux que vous utilisez si vous publiez directement les services de calcul d’itinéraire. Remplacez les URL et chemins d’accès aux données indiqués par ceux de votre déploiement.

Les étapes font référence à un déploiement ArcGIS Enterprise on Kubernetes s’exécutant sur https://dev0017162.esri.com/arcgis. Les services de calcul d’itinéraire sont publiés à partir d’un jeu de données réseau appelé Routing_ND, contenu dans un jeu de classes d’entités appelé Routing dans la géodatabase fichier NorthAmerica.gdb.

  1. Connectez-vous au répertoire des services pour le déploiement (par exemple, https://dev0017162.esri.com/arcgis/rest/services) en saisissant les informations de connexion du compte d’administrateur principal.
  2. Accédez au point de terminaison Publishing Routing Services du service de géotraitement PublishingTools dans le dossier System (par exemple, https://dev0017162.esri.com/arcgis/rest/services/System/PublishingTools/GPServer/Publish%20Routing%20Services).
  3. Cliquez sur le lien Submit job (Soumettre la tâche). figurant en bas de la page.
  4. Dans le formulaire visant en soumettre la tâche, procédez comme suit :
    1. Pour le paramètre networkDataset, spécifiez la valeur sous forme de valeur JSON contenant les propriétés "datastoreId" et "path". La valeur "datastoreId" est l’ID de l’élément de data store référençant l’espace de travail du jeu de données réseau : elle est créée lorsque vous configurez les dossiers partagés à la création de l’organisation ArcGIS Enterprise. La valeur "path" est le chemin d’accès relatif au jeu de données réseau dans le data store. Si, par exemple, le chemin d’accès au catalogue du jeu de données réseau dans une géodatabase fichier sur le partage de fichiers est /net/data/NorthAmerica.gdb/Routing/Routing_ND et que l’élément de data store portant l’ID 3eba512c2a0841d5adcc4c83029d8bf6 fait référence à /net/data, la valeur du paramètre serait spécifiée de la façon suivante :
      {
    "datastoreId": "3eba512c2a0841d5adcc4c83029d8bf6",
    "path": "/NorthAmerica.gdb/Routing/Routing_ND"
}
    2. N’indiquez aucune valeur pour le paramètre networkDatasetExtents.
    3. Pour le paramètre serviceFolder, spécifiez un nom pour le dossier d’un serveur qui contiendra tous les services de calcul d’itinéraire créés par cet outil.
    4. Pour le paramètre solverTypes, choisissez la valeur par défaut, car celle-ci indique que l’outil crée des services de calcul d’itinéraire pour tous les solveurs Network Analyst.
    5. N’indiquez aucune valeur pour le paramètre configFile.
    6. Pour le paramètre authenticationInfo, spécifiez les informations d’authentification telles que le jeton à utiliser pour publier les services. Spécifiez la valeur pour ce paramètre, au format JSON, contenant la propriété "token" et, si vous le souhaitez, une propriété "referer" contenant la valeur du référant qui a été spécifiée à la génération du jeton.
      Attention :

      Si aucune valeur n’est spécifiée pour le paramètre authenticationInfo, l’outil utilise le jeton de l’utilisateur connecté au répertoire des services. Dans la plupart des cas, ce jeton expire avant que l’outil ne mène à bien son exécution, ce qui aboutit à un échec de l’outil.

      Pour obtenir un jeton, appelez l’opération Generate Token (Générer un jeton) à partir de votre portail d’entreprise. Accédez au point de terminaison de génération du jeton de votre portail d’entreprise (https://dev0017162.esri.com/arcgis/sharing/rest/generateToken, par exemple) et générez un jeton qui soit valide une journée en spécifiant les valeurs suivantes dans le formulaire Web Générer un jeton :

      • Username : nom d’utilisateur de l’administrateur principal.
      • Password : mot de passe de l’utilisateur chargé de l’administration principal.
      • Client : sélectionnez l’option Webapp URL (URL de l’application Web) et spécifiez l’URL de votre portail d’entreprise (https://dev0017162.esri.com/arcgis, par exemple).
      • Expiration : 1 day (1 jour).
      • Format : JSON

      Cliquez sur le bouton Generate Token (Générer un jeton). Cette opération a pour effet de générer un objet JSON qui ressemble à

      Sortie de l’outil Générer un jeton

      {
  "token": "Ci4vgz18Vto2bK7mXVXLOE3XREXmt4sUI-QR60jApa0-Abr9UDZCWtnphxXKcQwJzh6RnHfxnkuIqQtLMVRK5OMXuFEK2E_AQtQMfTldvMagR1pPnWCPXms13QR_kMaLo_gh9gxAAi3t7xfE8RY7xPUIY5cuqGYP-WxWRp_IUgJD29FOXvVtLLisTu1THMpF-g0hlc3W5wJJ67SHGGqm8w.D",
  "expires": 1635360389770,
  "ssl": true
}

      La valeur du paramètre authenticationInfo est la valeur JSON obtenue à l’issue de l’exécution de l’opération Generate Token avec la propriété "referer" ajoutée à la chaîne JSON. Si, par exemple, vous avez spécifié https://dev0017162.esri.com/arcgis comme valeur de l’URL de l’application Web lors de la génération du jeton, la chaîne JSON de la valeur du paramètre authenticationInfo doit correspondre à la suivante :

      Exemple de valeur pour le paramètre authenticationInfo

      {
  "token": "Ci4vgz18Vto2bK7mXVXLOE3XREXmt4sUI-QR60jApa0-Abr9UDZCWtnphxXKcQwJzh6RnHfxnkuIqQtLMVRK5OMXuFEK2E_AQtQMfTldvMagR1pPnWCPXms13QR_kMaLo_gh9gxAAi3t7xfE8RY7xPUIY5cuqGYP-WxWRp_IUgJD29FOXvVtLLisTu1THMpF-g0hlc3W5wJJ67SHGGqm8w.D",
  "expires": 1635360389770,
  "ssl": true,
  "referer": "https://dev0017162.esri.com/arcgis"
}
      Attention :

      La chaîne JSON spécifiée comme valeur du paramètre authenticationInfo doit inclure la propriété "referer" correspondant à la valeur du paramètre Webapp URL (URL de l’application Web) lors de la génération du jeton. Dans le cas contraire, l’outil Publier des services de calcul d’itinéraire échoue et renvoie une erreur de jeton non valide.

    7. Cliquez sur le bouton Submit job (POST) (Soumettre la tâche - POST).

      L’exécution de l’outil Publier des services de calcul d’itinéraire commence. Un délai d’une heure peut être nécessaire à l’exécution complète de l’outil. Pour suivre la progression de l’outil tout au long de son exécution, cliquez sur le lien Check Job Details Again (Revérifier les détails de la tâche) pour examiner le message de statut le plus récent. Utilisez la valeur Job ID (ID de tâche) pour que l’outil vérifie, lors de son exécution, le statut et les résultats en parcourant l’URL (https://dev0017162.esri.com/arcgis/rest/services/System/PublishingTools/GPServer/Publish%20Routing%20Services/jobs/jd891ca3b935d4ed9a6fd38646d31a99c, par exemple).

Lorsque l’outil a terminé, les services de calcul d’itinéraire sont publiés et configurés en tant que services utilitaires dans votre portail d’entreprise. Allouez les ressources appropriées aux services de calcul d’itinéraire en fonction de l’utilisation prévue au sein de votre organisation.

Vous avez un commentaire à formuler concernant cette rubrique ?

Dans cette rubrique
  1. Exemple de processus