Créer un localisateur d’adresses composite (Outils de géocodage)

Résumé

Crée un localisateur composite. Un localisateur composite se compose d’au moins deux localisateurs individuels qui permettent l’appariement d’adresses et de lieux à l’aide de plusieurs localisateurs.

En savoir plus sur les localisateurs composites

Utilisation

Avant de créer des localisateurs composites, utilisez l’outil Create Locator (Créer un localisateur) ou Create Feature Locator (Créer un localisateur d’entités) pour créer des localisateurs participants.
Une référence spatiale pour un localisateur composite est requise. La référence spatiale du premier localisateur participant est utilisée, sauf si vous spécifiez un système de coordonnées en sortie différent dans les paramètres d’environnement de l’outil.
Utilisez l’option Order by role and score (Ordre par rôle et score) pour le paramètre Result Order (Ordre de résultats) d’un localisateur à plusieurs rôles, d’un localisateur ArcGIS StreetMap Premium (par exemple) et de plusieurs localisateurs à un seul rôle. Cette option permet d’ordonner les localisateurs et les rôles en ordre de remplacement optimal.
Pour générer la syntaxe Python correcte du paramètre in_result_ordering, exécutez d’abord l’outil depuis le panneau Geoprocessing (Géotraitement) à l’aide de l’option de paramètre Result Order (Ordre de résultats) appropriée. Ouvrez ensuite le menu Run (Exécuter) et sélectionnez Copy Python Command (Copier la commande Python).

Etiqueter	Explication	Type de données
Localisateurs d’adresses	Localisateurs qui seront utilisés pour créer le localisateur composite. L’ordre des localisateurs participants détermine la manière de rechercher les candidats et de mettre en correspondance un lieu ou une adresse. Si vous géocodez une seule place ou adresse, elle est mise en correspondance à l’aide de tous les localisateurs participants sauf si le localisateur est spécifié avec un critère de sélection. Tous les candidats trouvés s’afficheront en fonction de l’ordre des localisateurs participants répertoriés. Si vous géocodez un tableau d’adresses ou de lieux, les adresses ou les lieux sont automatiquement mis en correspondance avec le premier meilleur candidat trouvé parmi les premiers localisateurs participants. Si la mise en correspondance de l’adresse ou du lieu n’aboutit pas, il/elle sera remplacé(e) par le localisateur suivant dans la liste. Un nom de référence pour chaque localisateur participant est requis. Nom du localisateur auquel le localisateur composite fait référence. N’utilisez pas d’espace ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères. Colonnes de la table de valeurs : Localisateurs d’adresses participants—Les localisateurs d’adresses participants. Nom—Un nom de référence pour chaque localisateur participant est requis.	Value Table
Appariement des champs	Appariement des champs en entrée utilisés par chaque localisateur participant avec les champs en entrée du localisateur d’origine. Cela inclut les champs et leur contenu qui sont générés par les localisateurs participants. Chaque champ en entrée unique est répertorié dans le paramètre Field Map (Appariement des champs). Sur la gauche de la colonne Input Fields (Champs en entrée) se trouve une liste de tous les champs en entrée du localisateur composite. Lorsque vous sélectionnez un champ, vous pouvez afficher les champs de chaque localisateur participant apparié à ce champ dans les colonnes Subfield (Sous-champ) et Properties (Propriétés). Ces champs sont les champs en entrée du localisateur composite. Attention : Ne supprimez aucun champ de localisateur du paramètre Field Map (Appariement des champs). Un localisateur composite créé sans tous les champs de localisateur n’est pas valide.	Field Mappings
Critères de sélection (Facultatif)	Critère de sélection de chaque localisateur participant. Un seul critère de sélection est pris en charge pour chaque localisateur participant. Lorsque vous créez un localisateur composite, vous pouvez spécifier les localisateurs utilisés en fonction des valeurs des champs des adresses en entrée. Par exemple, si le localisateur composite utilise un localisateur contenant des données de rue pour une ville particulière, vous pouvez filtrer les adresses ou lieux qui n’incluent pas ce nom de ville. L’utilisation de critères de sélection disqualifie les localisateurs participants qui ne répondent pas aux critères sur une adresse particulière afin d’augmenter l’efficacité du processus de géocodage. Par exemple, si un localisateur d’adresses est spécifié avec le critère de sélection `"City" = 'Atlanta'`, seules les adresses qui contiennent le nom de ville Atlanta sont géocodées à l’aide de ce localisateur. Remarque : Les critères de sélection sont utilisés si une table d’adresses avec plusieurs champs d’adresses en entrée est géocodée. Ils ne s’appliquent pas lors du géocodage d’une table dont les adresses se trouvent dans un seul champ ou lors de la recherche d’adresses dans une entrée uniligne dans la fenêtre Locate (Localiser). Pour spécifier un critère de sélection, cochez la case du localisateur sous la colonne Selection Criteria (Critères de sélection) en regard du localisateur d’adresses auquel vous voulez appliquer le critère. Vous pouvez saisir une expression telle que `"City" = 'Atlanta'` dans la zone de texte ou cliquer sur le bouton more (plus) pour ouvrir la boîte de dialogue Specify Locator Selection Criteria (Spécifier les critères de sélection du localisateur) et définir les critères. Colonnes de la table de valeurs : Localisateurs d’adresses—Localisateurs participants. Critères de sélection—Critères de sélection pour chaque localisateur participant.	Value Table
Localisateur d’adresses composite en sortie	Localisateur d’adresses composite qui va être créé. ArcGIS Pro permet uniquement d’enregistrer des localisateurs dans un dossier.	Address Locator
Ordre des résultats (Facultatif)	Indique l’ordre de remplacement des localisateurs participants avec lesquels les adresses peuvent être mises en correspondance, afin d’accroître la probabilité d’identification de la meilleure correspondance lors du géocodage. Use locator order (Utiliser l’ordre des localisateurs) : les localisateurs participants sont dans l’ordre dans lequel ils ont été ajoutés et sont conformes à l’ordre de remplacement décrit dans Combiner plusieurs localisateurs en un localisateur composite. Il s’agit de l’option par défaut. Order by role and score (Classement par rôle et par score) : les rôles individuels des localisateurs participants sont regroupés et classés du plus précis au moins précis. Les résultats sont en premier lieu renvoyés pour des rôles plus précis, suivis des rôles moins précis. Pour différents localisateurs avec le même rôle, les résultats sont renvoyés en fonction du score. Il est recommandé d’utiliser cette option si vous avez un localisateur à plusieurs rôles et plusieurs localisateurs à un seul rôle ou si vous avez plusieurs localisateurs à plusieurs rôles. Cela permet de classer automatiquement les localisateurs et rôles dans un ordre de remplacement optimal recommandé. Custom order (Ordre personnalisé) : un ordre de remplacement personnalisable pour les localisateurs participants est utilisé et permet d’insérer des localisateurs entre les rôles d’un localisateur à plusieurs rôles.	String

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator, {in_result_ordering})

Nom	Explication	Type de données
in_address_locators [[in_address_locator, name],...]	Localisateurs qui seront utilisés pour créer le localisateur composite. L’ordre des localisateurs participants détermine la manière de rechercher les candidats et de mettre en correspondance un lieu ou une adresse. Si vous géocodez une seule place ou adresse, elle est mise en correspondance à l’aide de tous les localisateurs participants sauf si le localisateur est spécifié avec un critère de sélection. Tous les candidats trouvés s’afficheront en fonction de l’ordre des localisateurs participants répertoriés. Si vous géocodez un tableau d’adresses ou de lieux, les adresses ou les lieux sont automatiquement mis en correspondance avec le premier meilleur candidat trouvé parmi les premiers localisateurs participants. Si la mise en correspondance de l’adresse ou du lieu n’aboutit pas, il/elle sera remplacé(e) par le localisateur suivant dans la liste. Un nom de référence pour chaque localisateur participant est requis. Nom du localisateur auquel le localisateur composite fait référence. N’utilisez pas d’espace ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères. Colonnes de la table de valeurs : `Participating Address Locators`—Les localisateurs d’adresses participants. `Name`—Un nom de référence pour chaque localisateur participant est requis.	Value Table
in_field_map	Appariement des champs en entrée utilisés par chaque localisateur participant avec les champs en entrée du localisateur d’adresse composite. Pour chaque champ en entrée de localisateur, mettez en forme les informations de champ comme dans cet exemple de chaîne : `"Address 'Address or Intersection' true true false 4 Text 0 0 ,First,'#',Street"`. Les informations de cette chaîne sont composées des éléments suivants : New field name (Nouveau nom de champ) (`Address`) : nom du nouveau champ du localisateur composite. L’un des localisateurs du composite peut avoir un champ `Address` et l’autre localisateur peut avoir un champ `Street Address`. Vous pouvez désigner le nouveau champ de localisateur composite par `Address`, pour référencer les deux champs de localisateur d’origine. Alias for the new field name (Alias du nom du nouveau champ) (`'Address or Intersection'`) : alias du nouveau champ de localisateur du localisateur composite. Pour un localisateur composite avec le nom du nouveau champ `Address`, vous pouvez choisir un alias `'Address or Intersection'` pour le champ. isEditable (`true`) : indique si le nouveau champ de localisateur composite peut être modifié. Les options sont `true` ou `false`. Allow NULL Values (Autoriser les valeurs nulles) (`true`) : indique si le nouveau champ de localisateur composite autorise les valeurs nulles. Les options sont `true` ou `false`. Required (Obligatoire) (`false`) : indique si le nouveau champ de localisateur composite est obligatoire. Les options sont `true` ou `false`. Length (Longueur) (`4`) : longueur du nouveau champ de localisateur composite. Type (`Text`) : type de données du nouveau champ de localisateur composite. Cette valeur doit toujours être `Text` pour un localisateur. Scale (Échelle) (`0`) : échelle du nouveau champ de localisateur composite. Toute valeur comprise entre 1 et 100 peut être utilisée. Cette valeur ne s’applique pas aux localisateurs, mais une valeur valide doit être utilisée. Precision (Précision) (`0`) : précision du nouveau champ de localisateur composite. Toute valeur comprise entre 1 et 100 peut être utilisée. Cette valeur ne s’applique pas aux localisateurs, mais une valeur valide doit être utilisée. Merge rule (Règle de combinaison) (`First`) : règle de combinaison du nouveau champ de localisateur composite. N’importe quelle valeur de règle de combinaison peut être utilisée. Cette valeur ne s’applique pas aux localisateurs, mais une valeur valide doit être utilisée. Delimiter (Délimiteur) (`'#'`) : délimiteur du nouveau champ de localisateur composite. Tous les délimiteurs pris en charge peuvent être utilisés Original locator field name (Nom de champ de localisateur d’origine) (`Street`) : nom de champ de localisateur dans le localisateur participant d’origine.	Field Mappings
in_selection_criteria [[in_address_locator, selection_criteria],...] (Facultatif)	Critère de sélection de chaque localisateur participant. Un seul critère de sélection est pris en charge pour chaque localisateur participant. L’utilisation de critères de sélection disqualifie les localisateurs participants qui ne répondent pas aux critères sur une adresse ou un lieu particulier afin d’augmenter l’efficacité du processus de géocodage. Reportez-vous à la rubrique Notions de base relative à la combinaison de localisateurs dans un localisateur composite pour en savoir plus sur l’utilisation de critères de sélection dans le processus de géocodage. Remarque : Les critères de sélection sont utilisés si une table d’adresses avec plusieurs champs d’adresses en entrée est géocodée. Ils ne s’appliquent pas lors du géocodage d’une table dont les adresses se trouvent dans un seul champ ou lors de la recherche d’adresses dans une entrée uniligne dans la fenêtre Locate (Localiser). Colonnes de la table de valeurs : `Address Locators`—Localisateurs participants. `Selection Criteria`—Critères de sélection pour chaque localisateur participant.	Value Table
out_composite_address_locator	Localisateur d’adresses composite qui va être créé. ArcGIS Pro permet uniquement d’enregistrer des localisateurs dans un dossier.	Address Locator
in_result_ordering (Facultatif)	Indique l’ordre de remplacement des localisateurs participants avec lesquels les adresses peuvent être mises en correspondance, afin d’accroître la probabilité d’identification de la meilleure correspondance lors du géocodage. `Use locator order` : les localisateurs participants suivent l’ordre dans lequel ils ont été ajoutés et respectent l’ordre de remplacement décrit dans Combiner plusieurs localisateurs en un localisateur composite. Il s’agit de l’option par défaut. La syntaxe est une chaîne de noms de localisateurs séparés par des virgules. Par exemple, pour un localisateur composite contenant deux localisateurs (tels qu’Atlanta.loc et Memphis.loc), la syntaxe doit être `"Atlanta, Memphis"`. `Order by role and score` : les rôles individuels des localisateurs participants sont regroupés et classés du plus précis au moins précis. Les résultats sont en premier lieu renvoyés pour des rôles plus précis, suivis des rôles moins précis. Pour différents localisateurs avec le même rôle, les résultats sont renvoyés en fonction du score. Il est recommandé d’utiliser cette option si vous avez un localisateur à plusieurs rôles et plusieurs localisateurs à un seul rôle ou si vous avez plusieurs localisateurs à plusieurs rôles. Cela permet de classer automatiquement les localisateurs et rôles dans un ordre de remplacement optimal recommandé. La syntaxe est une chaîne de groupements de rôles séparés par une virgule structurée sous la forme `[LocatorRole1](LocatorName1.LocatorRole1, LocatorName2.LocatorRole1)`. Par exemple, pour un localisateur composite contenant deux localisateurs à plusieurs rôles (tels qu’Atlanta.loc et Memphis.loc) contenant chacun un rôle PointAdresse et un rôle StreetAddress, la syntaxe doit être `"[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)"`. Les rôles doivent être classés du plus précis au moins précis. `Custom order` : un ordre de remplacement personnalisable pour les localisateurs participants est utilisé et permet d’insérer des localisateurs entre les rôles d’un localisateur à plusieurs rôles. La syntaxe est une chaîne de noms de localisateur et de rôles séparés par une virgule structurée sous la forme `LocatorName.LocatorRole`. Par exemple, pour un localisateur composite contenant deux localisateurs à plusieurs rôles (tels qu’Atlanta.loc et Memphis.loc) contenant chacun un rôle PointAddress et un rôle StreetAddress, la syntaxe doit être `"Atlanta.StreetAddress,Memphis.PointAddress,Memphis.StreetAddres,Atlanta.PointAddress"`. Les localisateurs et les rôles peuvent être placés dans n’importe quel ordre, mais le fait de placer les rôles moins précis avant les rôles plus précis risque d’engendrer un comportement imprévu. Pour générer la syntaxe Python correcte, exécutez d’abord l’outil à partir du panneau Geoprocessing (Géotraitement). Ensuite, ouvrez le menu Run (Exécuter) et sélectionnez Copy Python Command (Copier la commande Python).	String

Exemple de code

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

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction CreateCompositeAddressLocator en mode immédiat.

# Create a composite address locator using the StreetMap USA and Tutorial Atlanta locators.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta/"

# Set local variables:
USA_locator = "C:/data/locators/StreetMap_Premium_for_ArcGIS/North_America_2024R3/USA.loc"
Atlanta_locator = "C:/ArcTutor/Geocoding/atlanta/Atlanta.loc"
Atlanta_Composite = "C:/ArcTutor/Geocoding/atlanta/US_Atlanta_Composite.loc"

# Field mapping
address_field_map = "Address 'Street or Intersection' true true false 100 Text 0 0 ,First,#,Atlanta_locator,Address,0,0,USA_locator,Street;"
city_field_map = "City 'City or Placename' true true false 40 Text 0 0 ,First,#,Atlanta_locator,City,0,0,USA_locator,City;"
state_field_map = "State 'State' true true false 20 Text 0 0 ,First,#,Atlanta_locator,State,0,0,USA_locator,State;"
zip_field_map = "Zip 'Zipcode' true true false 10 Text 0 0 ,First,#,Atlanta_locator,Zip,0,0,USA_locator,ZIP"

composite_locator_field_map = address_field_map + city_field_map + state_field_map + zip_field_map

arcpy.geocoding.CreateCompositeAddressLocator("Atlanta_locator Atlanta;USA_locator USA", composite_locator_field_map,"Atlanta '\"City\" = 'Atlanta'';USA #",Atlanta_Composite)

Environnements

Mot-clé CONFIG en sortie, Système de coordonnées en sortie

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Créer un localisateur d’adresses composite (Outils de géocodage)

Résumé

Utilisation

Paramètres

Attention :

Remarque :

Environnements

Informations de licence

Rubriques connexes