Créer un localisateur (Outils de géocodage)

Résumé

Permet de créer un localisateur utilisable pour trouver l’emplacement d’une adresse ou d’un lieu, de convertir une table d’adresses ou de lieux en une collection d’entités ponctuelles ou encore d’identifier l’adresse d’un emplacement ponctuel.

Remarque :

Les localisateurs créés par cet outil sont utilisables dans ArcGIS Pro 2.2 ou une version ultérieure, ArcGIS Enterprise 10.6.1 ou une version ultérieure, et comme service de localisateur dans ArcMap. Les fonctionnalités de localisateur ne sont peut-être pas toutes prises en charge dans les versions Enterprise antérieures à la version 10.7. Cela sera désormais le cas, puisque des fonctionnalités supplémentaires sont ajoutées aux versions récentes du logiciel. Les localisateurs créés avec cet outil ne peuvent pas être utilisés en tant que localisateur local dans ArcMap.

Utilisation

Le rôle de localisateur définit le type de données exploitées (parcelle, axe médian de la rue, code postal, point d’intérêt, etc.) et fournit les champs qu’il convient d’utiliser lors de la génération du localisateur et des informations renvoyées dans les résultats du géocodage. Seuls les rôles pris en charge par la valeur Country or Region (Pays ou région) sélectionnée sont répertoriés avec les champs des rôles de localisateur correspondants.

Remarque :

Seule une table principale peut être utilisée par rôle pour créer un localisateur avec cet outil.

Le rôle de localisateur Point of Interest (Point d’intérêt) (PI) remplace la table d’alias de nom de lieu mais requiert une classe d’entités ponctuelles ou surfaciques de noms de lieu ainsi que l’adresse associée dans la table attributaire.

Les rôles de localisateur principaux fournis avec ArcGIS Pro permettent de créer les types de localisateur courants suivants :
- PointAddress : adresse reposant sur des points qui représentent les localisations des habitations et des bâtiments. Elle comporte une sous-adresse basée sur les points représentant les emplacements de sous-adresse des maisons ou des bâtiments, tels que les suites, les étages ou encore les appartements.
- Parcelle : adresse ou nom de parcelle basé sur des points ou des polygones représentant une parcelle de terrain considérée comme un bien immobilier et qui peut inclure une ou plusieurs maisons ou structures généralement dotées d’une adresse et d’un numéro d’identification de la parcelle, comme 17 011100120063.
- StreetAddress : adresse basée sur les rues où le numéro de domicile est interpolé à partir d’une plage de numéros. Elle comporte les intersections, les noms de rue, les îlots de rues, les intersections entre les rues et les [prolongements de rues].
- Point d’intérêt : divisions administratives, noms de lieux, commerces, lieux d’intérêt et entités géographiques (par exemple, Starbucks).
- DistanceMarker : adresse qui représente la distance linéaire le long d’une rue, généralement en kilomètres ou en miles, depuis un emplacement d’origine.
- DistanceRange : type de repère de distance représentant les valeurs de distance interpolées le long de l’axe médian de la rue basé sur des entités.
- Postal : codes postaux, codes postaux avec extensions et localités postales pour lesquels les données de référence des polygones doivent être utilisées pour renvoyer les meilleurs résultats de géocodage inverse.
- Localités : zones administratives ou autres telles que les villes, les quartiers, les États, etc. pour lesquelles les données de référence des polygones doivent être utilisées pour renvoyer les meilleurs résultats de géocodage inverse.
Cet outil peut être utilisé pour créer un localisateur multirôle. Un localisateur multirôle vous permet de combiner plusieurs couches de données de référence et rôles au sein d’un seul localisateur afin de rechercher plusieurs types d’emplacements simultanément. Si vous possédez plusieurs couches de même type de géométrie pouvant être attribuées au même rôle, mieux vaut fusionner les couches dans une seule couche et utiliser la couche fusionnée comme données de référence principales pour le rôle correspondant.

En savoir plus sur la combinaison de plusieurs rôles dans un localisateur unique
Les localisateurs créés à l’aide de cet outil prennent en charge les recherches globales de coordonnées (latitude/longitude, MGRS [Military Grid Reference System], DD [Degré décimal] ou USNG [United States National Grid]). Les données de référence principales utilisées pour créer le localisateur doivent contenir au moins une entité. La prise en charge de la recherche de coordonnées est désactivée ou activée sous Categories to support (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.
Les champs supplémentaires des données de référence peuvent être spécifiés et ajoutés au localisateur en tant que champs en sortie personnalisés lors de la création du localisateur. Ces champs permettent de fournir des informations supplémentaires sur les candidats du résultat de géocodage. Par exemple, si vous voulez savoir à quel îlot de recensement ou à quel district de brigade de pompiers une adresse est associée, vous pouvez géocoder les adresses et joindre spatialement les attributs de l’îlot de recensement ou du district de brigade de pompiers aux résultats du géocodage. En joignant spatialement les attributs des couches avec les informations supplémentaires aux données de référence utilisés 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. Les résultats du géocodage incluent les champs en sortie personnalisés supplémentaires et leurs valeurs.
Les classes d’entités et les tables représentées en tant que services ne sont pas des types de données pris en charge pour une utilisation en tant que données de référence principales et que tables des autres noms.
Les tables des autres noms peuvent servir pour tous les rôles de localisateur pris en charge et identifient les autres noms des entités dans les données de référence principales.

En savoir plus sur les tables des autres noms
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).
Pour générer la syntaxe Python correcte, exécutez d’abord l’outil depuis la fenêtre Geoprocessing (Géotraitement) avec les options de paramètre appropriées. Ouvrez ensuite le menu Run (Exécuter) et sélectionnez l’option Copy Python Command (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 afin que les résultats de géocodage s’affichent à l’élévation attendue sur la carte.

Etiqueter	Explication	Type de données
Pays ou région	Indique là où la logique de géocodage propre à un pays doit s’appliquer aux données de référence pour le localisateur considéré. La valeur par défaut correspond au paramètre régional du système d’exploitation. Il peut être spécifié en sélectionnant <As defined in data> dans la liste et en associant une valeur figurant parmi les données dans l’appariement de champ ; il est également possible d’appliquer un pays à l’ensemble du jeu de données en spécifiant un pays de la liste. Il fournit un modèle de pays contenant les noms de champs prévus qui apparaissent dans la valeur du paramètre Field Mapping (Appariement de champ) pour le pays spécifié du localisateur à créer. <As defined in data>—Valeur du code de pays comportant trois caractères définie dans les données de référence pour chaque entité Argentine—Argentine Samoa américaines—Samoa américaines Australie—Australie Autriche—Autriche Belgique—Belgique Brésil—Brésil Canada—Canada Suisse—Suisse Colombie—Colombie République tchèque—République tchèque Allemagne—Allemagne Danemark—Danemark Espagne—Espagne Estonie—Estonie Finlande—Finlande France—France Grande-Bretagne—Grande-Bretagne Guatemala—Guatemala Guam—Guam Inde—Inde Israël—Israël Italie—Italie Japan—Japan Corée du Sud—Corée du Sud Lituanie—Lituanie Lettonie—Lettonie Mariannes du Nord (îles)—Mariannes du Nord (îles) Pays-Bas—Pays-Bas Norvège—Norvège Nouvelle-Zélande—Nouvelle-Zélande Pologne—Pologne Porto Rico—Porto Rico Suède—Suède Iles Vierges américaines—Iles Vierges américaines États-Unis—États-Unis Dépendances américaines du Pacifique—Dépendances américaines du Pacifique Afrique du Sud—Afrique du Sud	String
Table(s) principale(s)	Classes d’entités des données de référence, et leurs rôles, utilisées pour créer le localisateur. Seule une table principale peut être utilisée par rôle. Les classes d’entités représentées en tant que services sont des types de données pris en charge pour une utilisation en tant que données de référence principales. Attention : Si un ensemble de définition est défini pour les données de référence principales 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 : Si 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. Colonnes de la table de valeurs : Table(s) principale(s)—Classes d’entités des données de référence principales à utiliser par le localisateur. Rôle—Rôle de localisateur qui définit le type de données utilisées comme données de référence principales pour le localisateur.	Value Table
Appariement de champ	Appariement des champs du jeu de données de référence principales pris en charge par le rôle de localisateur. Les champs signalés par un astérisque () en regard de leur nom sont requis par le rôle de localisateur. Appariez les champs pertinents pour chaque table à partir de la valeur du paramètre Primary Table(s) (Table[s] principale[s]). Remarque : Pour certaines valeurs des paramètres Primary Table(s) (Table[s] principale[s])* et Roles (Rôles), il se peut que vous ayez la possibilité d’utiliser un modèle de machine learning pour apparier automatiquement les champs dans les données avec les champs du localisateur. Cliquez sur le bouton Smart Field Mapping (Appariement intelligent des champs) pour commencer à apparier les champs automatiquement. Il est recommandé d’évaluer l’exactitude des résultats du processus d’appariement intelligent des champs. Remarque : Si vous utilisez la table des autres noms, appariez l’ID de jointure dans la valeur du paramètre Primary Table(s) (Table[s] principale[s]). Pour ajouter des champs en sortie personnalisés supplémentaires, saisissez le nom des champs dans le paramètre Custom Output Fields (Champs en sortie personnalisés). Les nouveaux champs sont ajoutés à la valeur du paramètre Field Mapping (Appariement de champ). Vous pouvez alors sélectionner les champs dans le paramètre Primary Table(s) (Table[s] principale[s]) qui comporte les valeurs supplémentaires à inclure dans le géocode en sortie.	String
Localisateur en sortie	Fichier de localisateur d’adresses en sortie.	Address Locator
Code de la langue	Indique là où la logique de géocodage propre à une langue doit s’appliquer aux données de référence pour le localisateur considéré. Si un champ de code de langue existe dans les données de référence principales, le fait de fournir un code de langue contribue à améliorer les résultats du géocodage. Il peut être spécifié en sélectionnant <As defined in data> dans la liste et en associant une valeur provenant des données de référence principales dans l’appariement de champ ; il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant une langue dans la liste. <As defined in data>—La valeur du code de langue comportant trois caractères définie dans les données de référence pour chaque entité sera utilisée. Basque—Basque Catalan—Catalan Tchèque—Tchèque Danois—Danois Néerlandais—Néerlandais Anglais—Anglais Estonien—Estonien Finlandais—Finlandais Français—Français Allemand—Allemand Galicien—Galicien Hébreu—Hébreu Italien—Italien Japonais—Japonais Coréen—Coréen Lituanien—Lituanien Letton—Letton Norvégien—Norvégien Polonais—Polonais Portugais—Portugais Espagnol—Espagnol Suédois—Suédois	String
Table des autres noms (Facultatif)	Tables contenant les autres noms des entités figurant dans les tables de rôles principales. Les tables représentées en tant que services sont des types de données pris en charge pour une utilisation en tant que tables d’autres noms. Attention : Si un ensemble de définition est défini pour la table de noms secondaires ou que des enregistrements sont sélectionnés, seuls les enregistrements interrogés et sélectionnés sont inclus lors de la création du localisateur. Colonnes de la table de valeurs : Table des autres noms—Table des autres noms pour les entités dans la classe d’entités des données de référence principales à utiliser par le localisateur. Rôle—Rôle de localisateur qui définit le type de données utilisées comme table des autres noms pour le localisateur.	Value Table
Appariement des champs d’autres données (Facultatif)	Appariement des champs de la table des autres noms aux champs des autres données pris en charge par le rôle de localisateur. Les champs signalés par un astérisque () en regard de leur nom sont requis par le rôle de localisateur. Appariez les champs pertinents pour chaque table à partir de la valeur du paramètre Alternate Name Tables (Table des autres noms)*. Remarque : Si les données sont normalisées et que la table principale ne contient pas de valeurs de noms de ville à la différence de la table des autres noms, il est possible d’apparier le champ `Primary Name Indicator` à un champ figurant dans la table des autres noms qui contient une valeur indiquant si l’enregistrement est le champ principal (vrai/faux ou Oui/Non, par exemple). Si ce champ n’est pas apparié, le premier enregistrement dans la table des autres noms est utilisé comme valeur principale.	String
Champs en sortie personnalisés (Facultatif)	Ajoute 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éocode ; toutefois, chaque nouveau champ est apparié à un champ des données de référence. Ce nouveau champ en sortie s’applique à tous les rôles utilisés dans le localisateur. Si le rôle du localisateur possède un côté droit et un côté gauche, _left et _right sont ajoutés à la fin du nom du champ. Le nombre maximal de champs pris en charge dans le localisateur est de 50. Si le champ dans les données de référence ne comporte aucune donnée, le champ en sortie personnalisé n’est pas renvoyé par le localisateur ou répertorié dans l’onglet Output fields (Champs en sortie) de la boîte de dialogue Locator Properties (Propriétés du localisateur) 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 champ. 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
Type de précision (Facultatif)	Spécifie la précision du localisateur. Remarque : Les localisateurs créés avec l’option Global Extra High (Extrêmement élevé global) ou Local Extra High (Extrêmement élevé local) peuvent être utilisés dans ArcGIS Pro 2.6 ou versions ultérieures et Enterprise 10.8.1 ou versions ultérieures. Globale extrêmement élevée—La précision est d’environ 1 centimètre, avec une cohérence mondiale. Il s’agit de l’option par défaut. Globale élevée—La précision est d’environ 0,5 mètre, avec une cohérence mondiale. Locale extrêmement élevée—Une précision accrue est utilisée pour les zones locales.	String
Compatibilité des versions (Facultatif)	Indique la version du localisateur qui va être créé. Lorsqu’une version est indiquée, les localisateurs peuvent être utilisés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. Version actuelle—Le localisateur est compatible avec la version ArcGIS Pro actuelle. Il n’est pas compatible avec les versions antérieures répertoriées comme autres options dans le menu déroulant. Par exemple, si Current version (Version actuelle) est sélectionné et que l’autre option est 3.0 – 3.3, le localisateur créé est uniquement pris en charge dans ArcGIS Pro versions 3.4 et ultérieures et dans Enterprise versions 11.4 et ultérieures. 3.0 - 3.3—Le localisateur est compatible avec les versions 3.0 à 3.3 d’ArcGIS Pro.	String

arcpy.geocoding.CreateLocator(country_code, primary_reference_data, field_mapping, out_locator, language_code, {alternatename_tables}, {alternate_field_mapping}, {custom_output_fields}, {precision_type}, {version_compatibility})

Nom	Explication	Type de données
country_code	Indique là où la logique de géocodage propre à un pays doit s’appliquer aux données de référence pour le localisateur considéré. Il peut être spécifié en utilisant `AS_DEFINED_IN_DATA` et une valeur pouvant être appariée depuis `primary_reference_data` dans `field_mapping` ; il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant un nom de code de pays de trois caractères (par exemple, `USA` pour les États-Unis d’Amérique, `CAN` pour le Canada ou `PRI` pour Porto Rico). Il fournit un modèle de pays contenant les noms de champs prévus qui sont mis à disposition du paramètre `field_mapping` pour le pays spécifié du localisateur à créer. `AS_DEFINED_IN_DATA`—La valeur du code de pays comportant trois caractères définie dans les données de référence pour chaque entité sera utilisée. `ARG`—Argentine `ASM`—Samoa américaines `AUS`—Australie `AUT`—Autriche `BEL`—Belgique `BRA`—Brésil `CAN`—Canada `CHE`—Suisse `COL`—Colombie `CZE`—République tchèque `DEU`—Allemagne `DNK`—Danemark `ESP`—Espagne `EST`—Estonie `FIN`—Finlande `FRA`—France `GBR`—Grande-Bretagne `GTM`—Guatemala `GUM`—Guam `IND`—Inde `ISR`—Israël `ITA`—Italie `JPN`—Japan `KOR`—Corée du Sud `LTU`—Lituanie `LVA`—Lettonie `MNP`—Mariannes du Nord (îles) `NLD`—Pays-Bas `NOR`—Norvège `NZL`—Nouvelle-Zélande `POL`—Pologne `PRI`—Porto Rico `SWE`—Suède `VIR`—Iles Vierges américaines `USA`—États-Unis `UMI`—Dépendances américaines du Pacifique `ZAF`—Afrique du Sud	String
primary_reference_data [[reference_data, {role}],...]	Classes d’entités des données de référence, et leurs rôles, utilisées pour créer le localisateur. Seule une table principale peut être utilisée par rôle. Les classes d’entités représentées en tant que services sont des types de données pris en charge pour une utilisation en tant que données de référence principales. Attention : Si un ensemble de définition est défini pour les données de référence principales 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 : Si 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. Colonnes de la table de valeurs : `Primary Table(s)`—Classes d’entités des données de référence principales à utiliser par le localisateur. `Role`—Rôle de localisateur qui définit le type de données utilisées comme données de référence principales pour le localisateur.	Value Table
field_mapping [field_mapping,...]	Appariement des champs du jeu de données de référence principales pris en charge par le rôle de localisateur. Chaque appariement de champs pour ce paramètre est au format suivant, dans lequel `<role name>` est le nom du rôle de localisateur, `<locator role field name>` est le nom du champ pris en charge par le rôle de localisateur, `<primary data>` est le nom des données utilisées dans le paramètre `primary_reference_data` et `<primary data field name>` est le nom du champ dans le jeu de données de référence principal. Vous trouverez ci-après l’exemple d’un `field_mapping` principal : # <role name>.<locator role field name> <primary data>.<primary data field name> # This shows an example: primary_reference_data_field_map = \ ["StreetAddress.HOUSE_NUMBER_FROM_LEFT 'streets'.L_F_ADD",\ "StreetAddress.HOUSE_NUMBER_TO_LEFT 'streets'.L_T_ADD",\ "StreetAddress.HOUSE_NUMBER_FROM_RIGHT 'streets'.R_F_ADD",\ "StreetAddress.HOUSE_NUMBER_TO_RIGHT 'streets'.R_T_ADD",\ "StreetAddress.STREET_PREFIX_DIR 'streets'.PREFIX",\ "StreetAddress.STREET_PREFIX_TYPE 'streets'.PRE_TYPE",\ "StreetAddress.STREET_NAME 'streets'.NAME",\ "StreetAddress.STREET_SUFFIX_TYPE 'streets'.TYPE",\ "StreetAddress.STREET_SUFFIX_DIR 'streets'.SUFFIX",\ "StreetAddress.CITY_LEFT 'streets'.CITYL",\ "StreetAddress.CITY_RIGHT 'streets'.CITYR",\ "StreetAddress.REGION_LEFT 'streets'.STATE_ABBR",\ "StreetAddress.REGION_RIGHT 'streets'.STATE_ABBR",\ "StreetAddress.POSTAL_LEFT 'streets'.ZIPL",\ "StreetAddress.POSTAL_RIGHT 'streets'.ZIPR"] Appariez les champs pertinents pour chaque table du paramètre `primary_reference_data`. Si vous choisissez de ne pas apparier un champ de données de référence facultatif utilisé par le rôle de localisateur d’adresses à un champ d’un jeu de données de référence, spécifiez qu’il n’y a pas d’appariement en utilisant `<None>` à la place du nom de champ. Pour déterminer la valeur `<locator role field name>` d’un champ de données de référence utilisé par un rôle de localisateur, ouvrez l’outil Create Locator (Créer un localisateur) dans ArcGIS Pro et sélectionnez le rôle de localisateur. Le nom qui s’affiche dans la colonne Field Name (Nom du champ) du paramètre Field Mapping (Appariement de champ) est le nom de rôle du champ. Remarque : Si vous utilisez la table des autres noms, appariez l’ID de jointure dans la valeur du paramètre `primary_reference_data`. Pour ajouter des champs en sortie personnalisés, les noms des champs doivent être définis dans le paramètre `custom_output_fields` ainsi que dans le paramètre `field_mapping`. Le paramètre `field_mapping` utilise le format `'<locator role field name>.<primary data field name>'`, dans lequel `<locator role field name>` est défini comme `'RoleName.CustomFieldName'` et `<primary data field name>` désigne le nom du champ dans le jeu de données de référence principal, comme indiqué dans les champs appariés figurant dans l’exemple ci-dessus. Si un champ personnalisé est ajouté à un rôle Street Address (Adresse), vous devez apparier `'StreetAddress.CustomFieldName_Left'` et `'StreetAddress.CustomFieldName_Right'` de chaque côté de la rue.	String
out_locator	Fichier de localisateur d’adresses en sortie.	Address Locator
language_code	Indique là où la logique de géocodage propre à une langue doit s’appliquer aux données de référence pour le localisateur considéré. Si un champ de code de langue existe dans les données de référence principales, le fait de fournir un code de langue contribue à améliorer les résultats du géocodage. Il peut être spécifié en sélectionnant `AS_DEFINED_IN_DATA` en tant que valeur `language_code` et en associant une valeur issue de `primary_reference_data` dans `field_mapping` ; il est également possible de l’appliquer à l’ensemble du jeu de données. Il suffit pour cela de sélectionner une langue via un code de langue composé de trois caractères qui représente la langue d’une adresse, par exemple `ENG` pour l’anglais. `AS_DEFINED_IN_DATA`—La valeur du code de langue comportant trois caractères définie dans les données de référence pour chaque entité sera utilisée. `BAQ`—Basque `CAT`—Catalan `CZE`—Tchèque `DAN`—Danois `DUT`—Néerlandais `ENG`—Anglais `EST`—Estonien `FIN`—Finlandais `FRE`—Français `GER`—Allemand `GLG`—Galicien `HEB`—Hébreu `ITA`—Italien `JPN`—Japonais `KOR`—Coréen `LIT`—Lituanien `LAV`—Letton `NOR`—Norvégien `POL`—Polonais `POR`—Portugais `SPA`—Espagnol `SWE`—Suédois	String
alternatename_tables [alternatename_tables,...] (Facultatif)	Tables contenant les autres noms des entités figurant dans les tables de rôles principales. Les tables représentées en tant que services sont des types de données pris en charge pour une utilisation en tant que tables d’autres noms. Attention : Si un ensemble de définition est défini pour la table de noms secondaires ou que des enregistrements sont sélectionnés, seuls les enregistrements interrogés et sélectionnés sont inclus lors de la création du localisateur. Colonnes de la table de valeurs : `Alternate Name Tables`—Table des autres noms pour les entités dans la classe d’entités des données de référence principales à utiliser par le localisateur. `Role`—Rôle de localisateur qui définit le type de données utilisées comme table des autres noms pour le localisateur.	Value Table
alternate_field_mapping [alternate_field_mapping,...] (Facultatif)	Apparie des champs de la table des autres noms aux champs des autres données pris en charge par le rôle de localisateur. Chaque appariement de champs doit utiliser le format suivant, dans lequel `<alternate name table role>` est le nom du rôle dans la table des autres noms, `<locator role alternate field name>` est le nom du champ des autres données pris en charge par le rôle de localisateur de la table des autres noms, `<alternate data table>` est le nom de la table des autres noms et `<alternate data table field name>` est le nom du champ dans la table des autres noms. Appariez les champs pertinents pour chaque table dans `alternatename_tables`. Vous trouverez ci-après l’exemple d’un `alternate_field_mapping` pour `alternatename_tables`. # <alternate name table role>.<locator role alternate field name> <alternate data table>.<alternate data table field name> # This shows an example: alternate_data__table_field_map = \ ["AlternateStreetName.STREET_NAME_JOIN_ID 'altname'.JOINID",\ "AlternateStreetName.STREET_PREFIX_DIR 'altname'.PRE_DIR",\ "AlternateStreetName.STREET_PREFIX_TYPE 'altname'.PRE_TYPE",\ "AlternateStreetName.STREET_NAME 'altname'.ST_NAME",\ "AlternateStreetName.STREET_SUFFIX_TYPE 'altname'.ST_TYPE",\ "AlternateStreetName.STREET_SUFFIX_DIR 'altname'.SUF_DIR"] Remarque : Si les données sont normalisées et que la table principale ne contient pas de valeurs de noms de ville à la différence de la table des autres noms, il est possible d’apparier le champ `Primary Name Indicator` à un champ figurant dans la table des autres noms qui contient une valeur indiquant si l’enregistrement est le champ principal (vrai/faux ou Oui/Non, par exemple). Si ce champ n’est pas apparié, le premier enregistrement dans la table des autres noms est utilisé comme valeur principale.	String
custom_output_fields [custom_output_fields,...] (Facultatif)	Ajoute 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éocode ; toutefois, chaque nouveau champ est apparié à un champ des données de référence. Ce nouveau champ en sortie s’applique à tous les rôles utilisés dans le localisateur. Si le rôle du localisateur possède un côté droit et un côté gauche, _left et _right sont ajoutés à la fin du nom du champ. Le nombre maximal de champs pris en charge dans le localisateur est de 50. Si le champ dans les données de référence ne comporte aucune donnée, le champ en sortie personnalisé n’est pas renvoyé par le localisateur ou répertorié dans l’onglet Output fields (Champs en sortie) de la boîte de dialogue Locator Properties (Propriétés du localisateur) Remarque : Vous devez d’abord inclure les noms de champ en sortie dans le paramètre `field_mapping`, puis dresser la liste des noms dans le paramètre `custom_output_fields`.	String
precision_type (Facultatif)	Spécifie la précision du localisateur. Remarque : Les localisateurs créés avec le type de précision `GLOBAL_EXTRA_HIGH` ou `LOCAL_EXTRA_HIGH` peuvent être utilisés dans ArcGIS Pro 2.6 ou versions suivantes et dans Enterprise 10.8.1 ou versions suivantes. `GLOBAL_EXTRA_HIGH`—La précision est d’environ 1 centimètre, avec une cohérence mondiale. `GLOBAL_HIGH`—La précision est d’environ 0,5 mètre, avec une cohérence mondiale. Il s’agit de l’option par défaut. `LOCAL_EXTRA_HIGH`—Une précision accrue est utilisée pour les zones locales.	String
version_compatibility (Facultatif)	Indique la version du localisateur qui va être créé. Lorsqu’une version est indiquée, les localisateurs peuvent être utilisés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. `CURRENT_VERSION`—Le localisateur est compatible avec la version ArcGIS Pro actuelle. Il n’est pas compatible avec les versions antérieures disponibles en tant qu’options pour le paramètre. Par exemple, si `CURRENT_VERSION` est sélectionné et que l’autre option est `V3_0_TO_3_3`, le localisateur créé est uniquement pris en charge dans ArcGIS Pro versions 3.4 et ultérieures et dans Enterprise versions 11.4 et ultérieures. `V3_0_TO_3_3`—Le localisateur est compatible avec les versions 3.0 à 3.3 d’ArcGIS Pro.	String

Exemple de code

Exemple 1 d’utilisation de la fonction CreateLocator (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction CreateLocator dans un script Python autonome.

# Description: Create a POI locator using a feature class in a file geodatabase
#              that contains points of interest for Arts & Entertainment
#              locations as reference data, where country_code and language_code
#              are defined in the data. The new locator will be created in a
#              file folder.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/RhodeIsland"

# Set local variables:
primary_reference_data = "RI_Arts_POI POI"
field_mapping = ["POI.PLACE_NAME 'RI_Arts_POI'.PLACE_NAME",\
                 "POI.CATEGORY 'RI_Arts_POI'.CATEGORY",\
                 "POI.SUBCATEGORY 'RI_Arts_POI'.SUBCATEGORY",\
                 "POI.HOUSE_NUMBER 'RI_Arts_POI'.HOUSE_NUMB",\
                 "POI.STREET_NAME 'RI_Arts_POI'.STREET_NAME",\
                 "POI.NEIGHBORHOOD 'RI_Arts_POI'.NEIGHBORHOOD",\
                 "POI.CITY 'RI_Arts_POI'.CITY_NAME",\
                 "POI.SUBREGION 'RI_Arts_POI'.SUBREGION",\
                 "POI.REGION 'RI_Arts_POI'.REGION_NAME",\
                 "POI.POSTAL 'RI_Arts_POI'.POSTAL_CODE",\
                 "POI.COUNTRY_CODE 'RI_Arts_POI'.COUNTRY_CODE",\
                 "POI.LANG_CODE 'RI_Arts_POI'.LANGUAGE_CODE",\
                 "POI.RANK 'RI_Arts_POI'.RANK"]
out_locator = "Arts_Entertainment_POIs"

# Run CreateLocator
arcpy.geocoding.CreateLocator("AS_DEFINED_IN_DATA", primary_reference_data, field_mapping,
                              out_locator, "AS_DEFINED_IN_DATA")

Exemple 2 d’utilisation de la fonction CreateLocator (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction CreateLocator dans un script autonome.

# Description: Create a POI locator using a shapefile that contains points
#              of interest for airport locations as reference data. The new
#              locator will be created in a file folder.

# Import system modules
import arcpy

# Set local variables:
country_code="USA"
primary_reference_data=r"C:\Data\airports.shp POI"
field_mapping=["POI.PLACE_NAME 'airports.shp'.name",\
               "POI.CATEGORY 'airports.shp'.type",\
               "POI.REGION 'airports.shp'.iso_region",\
               "POI.ZONE 'airports.shp'.iso_country"]
out_locator=r"C:\Data\Airports_Locator"
language_code="ENG"

# Run CreateLocator
arcpy.geocoding.CreateLocator(country_code, primary_reference_data, field_mapping,
                              out_locator, language_code)

Exemple 3 d’utilisation de la fonction CreateLocator (fenêtre Python)

Le script Python ci-après montre comment utiliser la fonction CreateLocator en mode immédiat.

# Description: Create a StreetAddress locator using a street centerline feature
#              class in a file geodatabase as reference data, where multiple
#              custom_output_fields are added to the locator for use in the
#              geocode result. country_code and language_code are specified and
#              will be applied to the entire reference dataset. The new locator
#              will be created in a file folder.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Denver"

# Set local variables
country_code = "USA"
primary_reference_data = "Street_Centerline StreetAddress"
field_mapping = ["StreetAddress.HOUSE_NUMBER_FROM_LEFT 'Street_Centerline'.L_F_ADD",\
                 "StreetAddress.HOUSE_NUMBER_TO_LEFT 'Street_Centerline'.L_T_ADD",\
                 "StreetAddress.HOUSE_NUMBER_FROM_RIGHT 'Street_Centerline'.R_F_ADD",\
                 "StreetAddress.HOUSE_NUMBER_TO_RIGHT 'Street_Centerline'.R_T_ADD",\
                 "StreetAddress.STREET_PREFIX_DIR 'Street_Centerline'.PREFIX",\
                 "StreetAddress.STREET_PREFIX_TYPE 'Street_Centerline'.TYPE",\
                 "StreetAddress.STREET_NAME 'Street_Centerline'.NAME",\
                 "StreetAddress.STREET_SUFFIX_TYPE 'Street_Centerline'.TYPE",\
                 "StreetAddress.STREET_SUFFIX_DIR 'Street_Centerline'.SUFFIX",\
                 "StreetAddress.POSTAL_LEFT 'Street_Centerline'.ZIPLEFT",\
                 "StreetAddress.POSTAL_RIGHT 'Street_Centerline'.ZIPRIGHT",\
                 "StreetAddress.CustomField1_left 'Street_Centerline'.LEFTFIRE",\
                 "StreetAddress.CustomField1_right 'Street_Centerline'.RTFIRE",\
                 "StreetAddress.CustomField2_left 'Street_Centerline'.LEFTEMS",\
                 "StreetAddress.CustomField2_right 'Street_Centerline'.RTEMS"]
out_locator = "DenverStreetsCustomFieldsLocator"
language_code = "ENG"

# Run CreateLocator
arcpy.geocoding.CreateLocator(country_code, primary_reference_data, field_mapping,
                              language_code, None, None, "CustomField1;CustomField2")

Exemple 4 d’utilisation de la fonction CreateLocator (fenêtre Python)

Le script Python ci-après montre comment utiliser la fonction CreateLocator en mode immédiat.

# Create a StreetAddress locator using a street centerline feature class and an alternate
# name table, for alternate street names, in a file geodatabase as reference data.
# The new locator will be created in a file folder.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta"

# Set local variables
primary_reference_data = "streets StreetAddress"
field_mapping = ["StreetAddress.STREET_NAME_JOIN_ID 'streets'.STREETID",\
                 "StreetAddress.HOUSE_NUMBER_FROM_LEFT 'streets'.L_F_ADD",\
                 "StreetAddress.HOUSE_NUMBER_TO_LEFT 'streets'.L_T_ADD",\
                 "StreetAddress.HOUSE_NUMBER_FROM_RIGHT 'streets'.R_F_ADD",\
                 "StreetAddress.HOUSE_NUMBER_TO_RIGHT 'streets'.R_T_ADD",\
                 "StreetAddress.STREET_PREFIX_DIR 'streets'.PREFIX",\
                 "StreetAddress.STREET_PREFIX_TYPE 'streets'.PRE_TYPE",\
                 "StreetAddress.STREET_NAME 'streets'.NAME",\
                 "StreetAddress.STREET_SUFFIX_TYPE 'streets'.TYPE",\
                 "StreetAddress.STREET_SUFFIX_DIR 'streets'.SUFFIX",\
                 "StreetAddress.CITY_LEFT 'streets'.CITYL",\
                 "StreetAddress.CITY_RIGHT 'streets'.CITYR",\
                 "StreetAddress.REGION_LEFT 'streets'.STATE_ABBR",\
                 "StreetAddress.REGION_RIGHT 'streets'.STATE_ABBR",\
                 "StreetAddress.POSTAL_LEFT 'streets'.ZIPL",\
                 "StreetAddress.POSTAL_RIGHT 'streets'.ZIPR"]
alternatename_tables = "altname AlternateStreetName"
alternate_field_mapping = ["AlternateStreetName.STREET_NAME_JOIN_ID 'altname'.STREETID",\
                           "AlternateStreetName.STREET_PREFIX_DIR 'altname'.PRE_DIR",\
                           "AlternateStreetName.STREET_PREFIX_TYPE 'altname'.PRE_TYPE",\
                           "AlternateStreetName.STREET_NAME 'altname'.ST_NAME",\
                           "AlternateStreetName.STREET_SUFFIX_TYPE 'altname'.ST_TYPE",\
                           "AlternateStreetName.STREET_SUFFIX_DIR 'altname'.SUF_DIR",\
                           "AlternateStreetName.PRIMARY_NAME_INDICATOR 'altname'.PRIMARY"]
out_locator = "AtlantaAlternateStreetsLocator"

# Run CreateLocator
arcpy.geocoding.CreateLocator("USA", primary_reference_data, field_mapping,
                              out_locator, "ENG", alternatename_tables,
                              alternate_field_mapping)

Exemple 5 d’utilisation de la fonction CreateLocator (script autonome)

Le script Python ci-après montre comment utiliser la fonction CreateLocator en mode immédiat.

# Description: Create a multirole locator (PointAddress & StreetAddress) using a hosted
# feature service from ArcGIS Online as reference data.
# country_code and language_code
# are specified and will be applied to the entire reference dataset.
# The new locator will be created in a file folder.

# Import system modules
import arcpy

# Sign in to ArcGIS Online to use feature services as input
arcpy.SignInToPortal("https://www.arcgis.com", "<username>", "<password>")

# Set local variables
country = "USA"
in_table = "https://services.arcgis.com/<layer_id>/arcgis/rest/services/<service_name>/FeatureServer/<layer_number> PointAddress;"\
           "https://services.arcgis.com/<layer_id>/arcgis/rest/services/<service_name>/FeatureServer/<layer_number> StreetAddress"
field_mapping = ["PointAddress.ADDRESS_JOIN_ID '0'.PT_ADDR_ID",\
                 "PointAddress.HOUSE_NUMBER '0'.ADDRESS",\
                 "PointAddress.STREET_NAME '0'.ST_NAME",\
                 "PointAddress.SIDE '0'.SIDE",\
                 "PointAddress.CITY '0'.CITY",\
                 "PointAddress.REGION '0'.STATE",\
                 "StreetAddress.HOUSE_NUMBER_FROM_LEFT '1'.L_F_ADD_INT",\
                 "StreetAddress.HOUSE_NUMBER_TO_LEFT '1'.L_T_ADD_INT",\
                 "StreetAddress.HOUSE_NUMBER_FROM_RIGHT '1'.R_F_ADD_INT",\
                 "StreetAddress.HOUSE_NUMBER_TO_RIGHT '1'.R_T_ADD_INT",\
                 "StreetAddress.STREET_PREFIX_DIR '1'.PREFIX",\
                 "StreetAddress.STREET_PREFIX_TYPE '1'.PRETYPE",\
                 "StreetAddress.STREET_NAME '1'.NAME",\
                 "StreetAddress.STREET_SUFFIX_TYPE '1'.TYPE",\
                 "StreetAddress.STREET_SUFFIX_DIR '1'.SUFFIX",\
                 "StreetAddress.CITY_LEFT '1'.PLACENAME_L",\
                 "StreetAddress.CITY_RIGHT '1'.PLACENAME_R",\
                 "StreetAddress.REGION_LEFT '1'.STATE",\
                 "StreetAddress.REGION_ABBR_LEFT '1'.STATE_L",\
                 "StreetAddress.REGION_RIGHT '1'.STATE",\
                 "StreetAddress.REGION_ABBR_RIGHT '1'.STATE_R"]
out_locator = r"C:\output\locators\MultiroleFeatureServiceBasedLocator"
language = "ENG"

# Run CreateLocator
arcpy.geocoding.CreateLocator(country, in_table, field_mapping, out_locator, language)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Créer un localisateur (Outils de géocodage)

Résumé

Remarque :

Utilisation

Remarque :

Paramètres

Attention :

Remarque :

Remarque :

Remarque :

Attention :

Remarque :

Remarque :

Environnements

Informations de licence

Rubriques connexes