Skip To Content

Configurer le portail pour géocoder des adresses

Une fonctionnalité utile des portails ArcGIS Enterprise est la capacité de représenter des adresses sur la carte ou de placer des noms à partir d’un fichier de valeurs séparées par des virgules (CSV), d’un fichier Microsoft Excel ou d’une table. Pour ce faire, vous devez vous assurer que le portail est doté d’un service de localisation valide (pour rechercher les adresses ou les lieux) et d’un serveur d’hébergement (pour lire les adresses ou les lieux et les envoyer au service de localisation).

Héritage :

Les services de localisation étaient auparavant nommés services de géocodage. Certains éléments de l’interface utilisateur logicielle et de l’API utilisent encore le terme service de géocodage à des fins de rétrocompatibilité.

Définir un service de localisation

Vous devez définir un service de localisation pour votre portail afin de géocoder un grand nombre d’adresses ou de noms de lieux à la fois, par exemple lorsque vous ajoutez un fichier CSV contenant des adresses à Map Viewer. Vous pouvez utiliser un service de localisation d’une organisation ArcGIS Online ou publier votre propre service de localisation (géocodage) sur l’un des serveurs fédérés du portail ou sur un site GIS Server autonome.

Le service de localisation ArcGIS Online, avec le géocodage par lots activé, doit être configuré pour permettre aux utilisateurs de créer des vues du localisateur. Si le proxy du service de géocodage ArcGIS Online est supprimé, la vue du localisateur cesse de fonctionner. Si vous avez configuré le service de localisation ArcGIS Online avant de procéder à la mise à niveau vers ArcGIS Enterprise 10.6.1, vous devez désactiver puis réactiver le service utilitaire Geocode ArcGIS Online pour prendre en charge les vues du localisateur.

Pour plus d’informations sur la définition d’un localisateur dans votre portail en vue d’activer le géocodage, reportez-vous à la rubrique Configurer des services utilitaires. Pour plus d’informations sur la configuration de votre propre service, consultez la section suivante.

Configurer votre propre service de localisation

Les portails ArcGIS Enterprise utilisent le ArcGIS World Geocoding Service hébergé dans ArcGIS Online par défaut. Si votre organisation possède ses propres données de localisateur à utiliser pour rechercher des adresses et des noms de lieux ou si votre portail n’a pas accès à ArcGIS Online, publiez un service de localisation (géocodage) et définissez-le comme localisateur de votre portail.

Activez les fonctionnalités Suggest (Suggérer) dans le service de localisation si vous souhaitez que des suggestions d’adresses ou de noms de lieux apparaissent lorsque les utilisateurs effectuent des recherches dans Map Viewer.

  1. Suivez les instructions contenues dans la rubrique Création d’un localisateur d’adresses dans l’aide d’ArcMap pour créer un localisateur à partir de vos données. Pour utiliser des suggestions dans Map Viewer (Visionneuse de carte), activez l’option Suggest (Suggérer) de l’outil Create Address Locator (Créer un localisateur d’adresses) lorsque vous créez le localisateur.
  2. Publiez le localisateur en tant que service en cliquant avec le bouton droit dessus dans l’arborescence du catalogue d'ArcMap ou d'ArcCatalog et en sélectionnant Share As Service (Partager en tant que service).

    Pour plus d’informations sur la publication d’un service, reportez-vous à la rubrique Procédure de publication d’un service dans l’aide d’ArcGIS Server.

  3. Si vous n’avez pas activé les suggestions sur le localisateur lors de sa création, vous pouvez le faire dans le service de localisation après sa publication. Ouvrez le Service Editor (Éditeur de services) du service dans ArcMap ou ArcGIS Server Manager, cliquez sur l’onglet Capabilities (Fonctionnalités) et activez la fonction Suggest (Suggérer).
  4. Configurez le service résultant en tant que localisateur pour votre portail. Accédez à Organization (Organisation) > Edit Settings (Modifier les paramètres) > Utility Services (Services utilitaires).

Configurer un stockage des données relationnelles avec un site GIS Server

Le site GIS Server que vous définissez comme serveur d’hébergement de votre portail doit être configuré avec un stockage des données relationnelles ArcGIS Data Store.

  1. Installez ArcGIS Data Store.
  2. Créez un stockage des données relationnelles.

    Lorsque vous créez le stockage des données relationnelles, spécifiez l'URL du site GIS Server à utiliser comme serveur d'hébergement de votre portail.

Fédérer le site GIS Server avec votre portail

Avant de désigner un site GIS Server comme serveur d'hébergement, vous devez le fédérer avec le portail. Le site GIS Server que vous fédérez avec le portail doit être configuré de façon à communiquer via HTTP et HTTPS ou HTTPS uniquement.

Pour en savoir plus, reportez-vous à la rubrique ;Fédérer un site ArcGIS Server avec votre portail.

Désigner le serveur d'hébergement

Désignez le site GIS Server que vous venez de fédérez avec le portail comme serveur d'hébergement.

  1. Choisissez le site GIS Server dans la liste déroulante de la section Serveur d'hébergement de la fenêtre Serveur.
  2. Cliquez sur Save (Enregistrer).

Configurer l’outil Geocode Locations (Géocoder des emplacements) à partir d’une table pour utiliser le service Esri World Batch Geocoder (Géocodeur mondial par lots Esri) et les vues du localisateur

Par défaut, le service Esri World Batch Geocoder est partagé avec l’organisation. Par défaut, les vues de localisateur du service Esri World Batch Geocoder (Géocodeur mondial par lots Esri) ne sont pas partagées. Pour soumettre des requêtes de géocodage par lots par rapport au service Esri World Batch Geocoder (Géocodeur mondial par lots Esri) et aux vues du localisateur à l’aide de l’outil Geocode Locations from Table (Géocoder des emplacements à partir d’une table) ou de Geocode Table (Géocoder une table), vous devez partager le service avec tout le monde.

  1. Accédez à l’onglet My Content (Mon contenu) de la page de contenu.
  2. Cliquez sur le localisateur AGO World Geocoder, ou la vue du localisateur correspondant à partager, puis ouvrez sa page des détails d’éléments.
  3. Cliquez sur Partager sur l'onglet Vue d'ensemble et sélectionnez Tout le monde.
  4. Cliquez sur OK.

L’utilisation du service Esri World Batch Geocoder ou d’une vue du localisateur dans l’outil Geocode Locations from Table (Géocoder des emplacements à partir d’une table) entraîne une consommation de crédits dans l’organisation ArcGIS Online que vous utilisez pour configurer le localisateur (service utilitaire de géocodage) du portail. Le nombre de requêtes de géocodage par lots simultanées pour le service Esri World Batch Geocoder et pour les vues du localisateur ne peut pas être configuré et est toujours défini sur un. L’utilisation des services de localisation avec l’outil Geocode Locations from Table (Géocoder des emplacements à partir d’une table) n’entraîne aucune consommation de crédits et vous pouvez configurer d’autres localisateurs pour envoyer plusieurs requêtes de géocodage par lots simultanées.

Ajouter une journalisation pour plus de commentaires pendant le géocodage par lots

Par défaut, le niveau de message du service de géocodage Geocoding Tools (Outils de géocodage) est défini sur Warning (Avertissement). Pour obtenir des messages d’erreur plus détaillés et de meilleures mise à jour sur le statut de votre tâche de géocodage par lots, vous pouvez définir le niveau de journalisation du service de géocodage Geocoding Tools (Outils de géocodage) sur Info.

  1. Accédez à l’instance Server Manager de votre serveur d’hébergement.
  2. Cliquez sur le dossier Utilities (Utilitaires) dans le répertoire de Server Manager.
  3. Cliquez sur le service de géotraitement Geocoding Tools (Outils de géocodage).
  4. Cliquez sur la bannière Parameters (Paramètres) située à gauche et redéfinissez Message Level (Niveau de message) sur Info. Cliquez ensuite, sur le bouton Save and Restart (Enregistrer et redémarrer) situé en haut à droite.

Redéfinir le niveau de journalisation sur Info a pour effet une légère baisse des performances, mais fournira de meilleurs commentaires sur l’avancée des tâches et plus d’informations sur les erreurs possibles si elles se produisent. Ces avantages sont perceptibles dans l’outil Geocode Locations from Table (Géocoder des emplacements à partir d’une table) et l’outil Geocode Table (Géocoder une table).

Configurer le nombre suggéré de requêtes de géocodage par lots simultanées pour votre localisateur

Le localisateur du portail peut également être utilisé par le service de géotraitement GeocodingTools qui s’exécute sur votre site GIS Server fédéré. Le service de géotraitement peut envoyer plusieurs requêtes simultanées au service utilitaire de géocodage en vue d'accélérer l'exécution globale du géocodage par lots. Le nombre de requêtes simultanées émises par le service de géotraitement peut être configuré par un administrateur du portail. Si le service de géotraitement émet un nombre excessif de requêtes simultanées au localisateur, les performances de ce dernier risquent d’être médiocres et l’exécution du service de géotraitement risque de connaître un nombre croissant d’échecs. C’est pour cette raison que l’administrateur doit définir le nombre d’instances utilisées par le service de géotraitement en fonction du nombre d’instances disponibles pour le service de localisation et configurer le nombre de requêtes de géocodage par lots simultanées qui peuvent être émises par n’importe quelle instance du service de géotraitement GeocodingTools.

Le nombre d’instances du service de localisation doit être supérieur ou égal au nombre d’instances disponibles dans le service de géotraitement GeocodingTools. Le nombre de requêtes de géocodage par lots simultanées doit être défini proportionnellement au nombre d’instances disponibles à la fois pour le localisateur et pour les services de géotraitement. Par exemple, si huit instances sont disponibles pour le service de localisation et que deux instances sont disponibles pour le service de géotraitement, le nombre suggéré de requêtes de géocodage par lots simultanées doit être défini sur quatre. Lors de son exécution, le service de géotraitement envoie quatre requêtes de géocodage par lots simultanées au service de localisation. Si un plus grand nombre d’instances est disponible pour le service de localisation, le nombre de requêtes de géocodage par lots simultanées doit être ajusté conformément afin d’optimiser l’utilisation des instances pour le service de localisation.

Notez que le service Esri World Batch Geocoder ne peut pas être configuré de façon à utiliser plus de requêtes simultanées. La configuration suivante s'applique à tous les autres services de localisation publiés qui sont configurés en tant que services utilitaires.

Pour configurer le nombre suggéré de requêtes de géocodage par lots simultanées pour votre service de localisation, utilisez les étapes suivantes :

  1. Accédez à l'emplacement de partage du répertoire Portal for ArcGIS et connectez-vous en tant que membre doté de privilèges administratifs. L’URL est au format https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
  2. Accédez à Accueil > Portails > Auto.
  3. Au bas de la page, cliquez sur Mettre à jour.
  4. Dans la zone de texte Geocode Service (Service de géocodage), les services de localisation actuellement configurés avec le portail apparaissent. Pour les services qui autorisent le géocodage par lots (identifiables à leur propriété batchdéfinie sur true), vous pouvez configurer le nombre suggéré de requêtes de géocodage par lots simultanées. Choisissez le service à configurer avec cette propriété. La valeur JSON dans la zone de texte Service de géocodage sera au format suivant :
    [{
            "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            "northLat" : "Ymax",
            "southLat" : "Ymin",
            "eastLon" : "Xmax",
            "westLon" : "Xmin",
            "name" : "Esri World Geocoder",
            "batch": false,
            "suggest" : true
        }, {
            "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer",
            "name" : "Streetmap Premium USA Geocoder",
            "placeholder" : "Find address or place",
            "singleLineFieldName" : "SingleLine",
            "batch" : true,
            "placefinding" : true,
            "suggest" : true,
            "zoomScale" : 10000
        }]

  5. Ajoutez la propriété numBatchThreads à tous les services de localisation que vous souhaitez utiliser avec le service de géotraitement GeocodingTools. Pour définir la valeur numBatchThreads, déterminez d’abord le nombre de requêtes de géocodage par lots simultanées que vous voulez activer pour un service de localisation donné, puis définissez la propriété sur ce nombre. Notez qu’afin de configurer numBatchThreads dans le service de localisation, batch doit être défini sur true dans le service.

    Dans cet exemple, le nombre de requêtes de géocodage par lots simultanées qui peuvent être autorisées pour le service utilitaire Streetmap Premium USA Geocoder est défini sur quatre.

    [{
            "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            "northLat" : "Ymax",
            "southLat" : "Ymin",
            "eastLon" : "Xmax",
            "westLon" : "Xmin",
            "name" : "Esri World Geocoder",
            "batch": false,
            "suggest" : true
        }, {
            "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer",
            "name" : "Streetmap Premium USA Geocoder",
            "placeholder" : "Find address or place",
            "singleLineFieldName" : "SingleLine",
            "batch" : true,
            "placefinding" : true,
            "suggest" : true,
            "zoomScale" : 10000,
            "numBatchThreads" : 4
        }]

  6. Une fois la valeur JSON mise à jour dans la zone de texte Service de géocodage, cliquez sur Mettre à jour l'organisation au bas de la page.

Utilisez l’url du service de localisation avec la propriété numBatchThreads ajoutée comme geocodeServiceURL dans les tâches AnalyzeGeocodeInput et BatchGeocode. Pour plus d'informations sur l'exécution des outils au sein du service GeocodingTools via les tâches de l'API REST d'ArcGIS, consultez la documentation de l'API REST d'ArcGIS.