Créer un localisateur d’entités (Géocodage)

Synthèse

Crée un localisateur à l’aide de données de référence contenant un nom ou une valeur unique pour chaque entité stockée dans un champ unique. Un localisateur créé avec cet outil a de vastes applications. Il peut être utilisé pour rechercher des noms ou des attributs uniques d’entités, tels que des compteurs d’eau, des noms de lieu courts, des tours de relais ou des chaînes alphanumériques utilisées pour identifier des localisations (par exemple, N1N115).

Les localisateurs créés par cet outil utilisent les valeurs indexées dans un champ unique pour y rechercher des valeurs et retourner ces valeurs sous la forme d’un ensemble de points ou pour identifier des entités à proximité d’un emplacement de point. Les tables d’adresses qui peuvent être géocodées à l’aide d’un localisateur créé avec cet outil doivent également contenir un champ unique comprenant le même nom ou la même valeur unique pouvant servir à identifier les emplacements.

Remarque :

Les localisateurs créés avec cet outil peuvent être utilisés dans ArcGIS Pro 2.5 ou version ultérieure ou Enterprise 10.8 ou version ultérieure et en tant que service de localisateur dans ArcMap. Les localisateurs créés avec cet outil ne peuvent pas être utilisés en tant que localisateur local dans ArcMap.

Utilisation

  • Les classes d’entités représentées en tant que services sont des types de données pris en charge à utiliser comme données de référence.

  • L’outil prend en charge les classes d’entités contenant des géométries de point et de polygone en tant que données de référence.

  • Un localisateur créé avec cet outil peut être utilisé pour rechercher des identifiants uniques ou des valeurs de chaîne courte ne comportant pas plus de cinq mots.

  • Les localisateurs créés à l’aide de cet outil prennent en charge les recherches globales de coordonnées (latitude/longitude, MGRS, DD ou USNG). Les données de référence principales utilisées pour créer le localisateur doivent contenir au moins une entité. La recherche de coordonnées est désactivée ou activée sous Catégories à prendre en charge sur la page Geocoding options (Options de géocodage) de la boîte de dialogue Locator Properties (Propriétés du localisateur) du localisateur.

  • Des champs supplémentaires issus des données de référence peuvent être fournis et ajoutés au localisateur en tant que champs en sortie personnalisés lorsque vous créez le localisateur. Ces champs permettent de fournir des informations supplémentaires sur les candidats du résultat de géocodage. Par exemple, si vous souhaitez savoir à quel îlot de recensement ou district de protection contre les incendies une bouche d’incendie est associée, vous pouvez géocoder l’identifiant de la bouche d’incendie et joindre spatialement les attributs de l’îlot de recensement ou du district aux résultats du géocodage. En joignant spatialement les attributs des couches contenant les informations supplémentaires aux données de référence utilisées pour créer le localisateur, vous pouvez spécifier les champs joints en tant que champs en sortie personnalisés définis par l’utilisateur lors de la création du localisateur. Le résultat de géocodage inclura les champs en sortie personnalisés supplémentaires et leurs valeurs.

  • La sortie de cet outil peut être utilisée comme entrée de l’outil Créer un localisateur d’adresses composite. Cependant, l’association d’un localisateur créé avec cet outil à des localisateurs d’adresse basés sur les rôles dans un localisateur composite doit être réalisée avec précaution car l’appariement de champ du champ de rôle de localisateur d’entité Name (Nom) peut générer un comportement inattendu. Il est recommandé d’utiliser à la place un localisateur créé avec l’outil Créer un localisateur basé sur le rôle POI (Point d’intérêt).

  • Pour générer la syntaxe Python correcte, exécutez d’abord l’outil depuis la fenêtre Géotraitement avec les options de paramètre appropriées. Ouvrez ensuite le menu Exécuter et sélectionnez l’option Copier la commande Python.

  • Vous pouvez créer des localisateurs en utilisant des classes d’entités ponctuelles de type z comme données de référence principales. Les entités de type z doivent être créées à une élévation absolue de telle sorte que les résultats de géocodage soient affichés à l’élévation attendue sur la carte.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Classes d’entités ou couche d’entités des données de référence qui sera utilisée pour créer le localisateur.

Les classes d’entités représentées en tant que services sont des types de données pris en charge à utiliser comme données de référence.

Attention :

Lorsqu’un ensemble de définition est défini pour les données de référence ou que des entités sont sélectionnées, seules les entités interrogées et sélectionnées sont incluses lors de la création du localisateur.

Remarque :

Lorsque vous créez un localisateur à l’aide de données de référence contenant des millions d’entités, vous devez disposer d’un espace disque disponible équivalant à trois à quatre fois le volume des données sur le lecteur contenant votre répertoire temporaire. En effet, les fichiers utilisés pour générer le localisateur sont enregistrés dans le répertoire temporaire avant que le localisateur ne soit copié dans l’emplacement en sortie. Si vous ne disposez pas d’un espace disque suffisant, l’exécution de l’outil échoue par manque d’espace. Lors de la création de localisateurs de grande envergure, votre machine doit également être dotée de suffisamment de RAM pour traiter des processus qui sollicitent considérablement la mémoire.

Feature Layer
Champs de recherche

Apparie le champ des données de référence au champ utilisé pour effectuer une recherche dans la valeur du paramètre Entités en entrée. Les champs signalés par un astérisque (*) en regard de leur nom sont obligatoires. Le champ sélectionné sera indexé et utilisé pour la recherche.

Field Info
Localisateur en sortie

Le fichier de localisateur en sortie à créer dans un dossier de fichiers. Une fois un localisateur créé, les propriétés supplémentaires et les options peuvent être modifiées dans les paramètres du localisateur.

Address Locator
Champs de localisateur supplémentaires
(Facultatif)

Apparie des champs supplémentaires d’étendue et de classement s’ils existent dans les données. Le champ Rank est utilisé pour trier les résultats des requêtes ou des candidats ambigus ayant les mêmes nom et score. Les champs d’étendue aident à définir l’étendue de la carte pour afficher des résultats géocodés.

Field Info
Champs en sortie personnalisés
(Facultatif)

Permet d’ajouter des champs en sortie définis par l’utilisateur au localisateur. Les valeurs spécifiées pour ce paramètre définissent les noms des champs en sortie personnalisés qui sont renvoyés dans les résultats du géocodage ; toutefois, chaque nouveau champ est apparié à un champ des données de référence. Le nombre maximal de champs pris en charge dans le localisateur est de 50.

Procédez comme suit pour ajouter des champs en sortie personnalisés au localisateur à utiliser dans les résultats de géocodage :

  • Saisissez les noms des champs en sortie personnalisés. Les noms de champ en sortie sont ajoutés à l’appariement de champs.
  • Sélectionnez le champ dans les données de référence comportant les valeurs supplémentaires à inclure dans le géocode en sortie.
String

arcpy.geocoding.CreateFeatureLocator(in_features, search_fields, output_locator, {locator_fields}, {custom_output_fields})
NomExplicationType de données
in_features

Classes d’entités ou couche d’entités des données de référence qui sera utilisée pour créer le localisateur.

Les classes d’entités représentées en tant que services sont des types de données pris en charge à utiliser comme données de référence.

Attention :

Lorsqu’un ensemble de définition est défini pour les données de référence ou que des entités sont sélectionnées, seules les entités interrogées et sélectionnées sont incluses lors de la création du localisateur.

Remarque :

Lorsque vous créez un localisateur à l’aide de données de référence contenant des millions d’entités, vous devez disposer d’un espace disque disponible équivalant à trois à quatre fois le volume des données sur le lecteur contenant votre répertoire temporaire. En effet, les fichiers utilisés pour générer le localisateur sont enregistrés dans le répertoire temporaire avant que le localisateur ne soit copié dans l’emplacement en sortie. Si vous ne disposez pas d’un espace disque suffisant, l’exécution de l’outil échoue par manque d’espace. Lors de la création de localisateurs de grande envergure, votre machine doit également être dotée de suffisamment de RAM pour traiter des processus qui sollicitent considérablement la mémoire.

Feature Layer
search_fields

Apparie le champ des données de référence au champ utilisé pour effectuer une recherche dans la valeur du paramètre in_features. L’appariement de search_fields s’effectue au format suivant, dans lequel <locator field name> est le nom du champ pris en charge par le rôle de localisateur et <data field name> est le nom du champ utilisé pour la recherche dans le paramètre in_features.

# <locator field name> <data field name>

# This shows an example:
reference_data_field_map = """
"'Name' AssetName"
"""

Le champ sélectionné sera indexé et utilisé pour la recherche. Appariez le champ pertinent pour les données de référence dans le paramètre in_features.

Field Info
output_locator

Le fichier de localisateur en sortie à créer dans un dossier de fichiers. Une fois un localisateur créé, les propriétés supplémentaires et les options peuvent être modifiées dans les paramètres du localisateur.

Address Locator
locator_fields
(Facultatif)

Apparie des champs supplémentaires d’étendue et de classement s’ils existent dans les données. Le champ Rank est utilisé pour trier les résultats des requêtes ou des candidats ambigus ayant les mêmes nom et score. Les champs d’étendue aident à définir l’étendue de la carte pour afficher des résultats géocodés. La cartographie de locator_fields s’effectue sous le format suivant :

# <additional locator field name> <additional data field name>

# This shows an example:
additional_fields_map = """
"'Rank' RANK;'Min X' Xmin;
'Max X' Xmax;'Min Y' Ymin;
'Max Y' Ymax"
"""

Le champ <additional locator field name> est le nom du champ supplémentaire pris en charge par le localisateur et le champ <additional data field name> le nom du champ figurant dans le paramètre in_features. Appariez les champs pertinents pour les données de référence dans le paramètre in_features.

Field Info
custom_output_fields
[custom_output_fields,...]
(Facultatif)

Permet d’ajouter des champs en sortie définis par l’utilisateur au localisateur. Les valeurs spécifiées pour ce paramètre définissent les noms des champs en sortie personnalisés qui sont renvoyés dans les résultats du géocodage ; toutefois, chaque nouveau champ est apparié à un champ des données de référence. Le nombre maximal de champs pris en charge dans le localisateur est de 50.

Remarque :

Vous devez d’abord inclure les noms de champs en sortie dans le paramètre field_mapping, puis dresser la liste des noms dans le paramètre custom_output_fields.

String

Exemple de code

Exemple 1 d’utilisation de l’outil CreateFeatureLocator (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CreateFeatureLocator dans un script autonome.

# Description: Create a feature locator using local data.

# Import system modules
import arcpy

# Set local variables
in_features = r"C:\data\arizona.gdb\az_points"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\az_points_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"

# Run CreateFeatureLocator
arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)
Exemple 2 d’utilisation de l’outil CreateFeatureLocator (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CreateFeatureLocator dans un script autonome.

# Description: Create a feature locator using data from a hosted feature service in ArcGIS Online.

# Import system modules
import arcpy

# Sign in to Portal
arcpy.SignInToPortal("https://www.arcgis.com", "<username>", "<password>")

# Set local variables
in_features = "https://services.arcgis.com/<layer_id>/arcgis/rest/services/<service_name>/FeatureServer/<layer_number>"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\service_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"

arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)