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

Résumé

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 de vos 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 emplacements (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, 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.

• La sortie de cet outil peut être utilisée comme entrée de l’outil Create Composite Address Locator (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) .

Syntaxe

arcpy.geocoding.CreateFeatureLocator(in_features, search_fields, output_locator, {locator_fields})

Paramètre	Explication	Type 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 de données de référence au champ utilisé pour effectuer une recherche dans le paramètre in_features. L’appariement search_fields s’effectue sous le 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> est 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

Exemple de code

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

Le script Python ci-dessous illustre l'utilisation de l'outil 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"
# Execute 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 l'outil 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)

Environnements

Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui