Créer un localisateur d'adresses composite (Géocodage)

Synthèse

Crée un localisateur composite. Un localisateur composite est composé d’au moins deux localisateurs individuels qui permettent de mettre en correspondance des adresses et des lieux à l’aide de plusieurs localisateurs.

Pour 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 requis. 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, un localisateur ArcGIS StreetMap Premium (par exemple) et 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 pour le 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. Ensuite, ouvrez le menu Run (Exécuter) et sélectionnez Copy Python Command (Copier la commande Python).

Paramètres

ÉtiquetteExplicationType 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. Lorsque vous géocodez une seule place ou adresse, elle sera 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 seront 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. Il s’agit du nom du localisateur auquel fait référence le localisateur composite. N’utilisez pas d’espace ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères.

Value Table
Appariement des champs

L’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.

Lors de la création d’un localisateur composite, vous pouvez spécifier les localisateurs utilisés en fonction des valeurs des champs d’adresse 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 toutes les adresses ou tous les 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 d’une rue est spécifié avec un critère de sélection sous la forme "City" = 'Atlanta', seules les adresses qui contiennent le nom de ville Atlanta sont géocodées à l’aide de ce localisateur.

Pour spécifier un critère de sélection, sous la colonne Selection Criteria (Critères de sélection), cochez la case du localisateur 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 (Critères de sélection du localisateur) qui permet de définir les critères.

Value Table
Localisateur d’adresses composite en sortie

Localisateur d’adresses composite qui va être créé. ArcGIS AllSource permet uniquement d’enregistrer des localisateurs dans un dossier de fichiers.

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 seront 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 seront groupé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})
NomExplicationType 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. Lorsque vous géocodez une seule place ou adresse, elle sera 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 seront 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. Il s’agit du nom du localisateur auquel fait référence le localisateur composite. N’utilisez pas d’espace ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères.

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) : nouveau nom de champ du localisateur composite.

    Un localisateur du localisateur composite peut comporter un champ Address et l’autre un champ Street Address. Vous pouvez désigner le nouveau champ de localisateur composite par Address, ce qui fait référence aux deux champs de localisateur d’origine.

  • Alias for the new field name (Alias du nouveau nom de champ) ('Address or Intersection') : alias du nouveau champ de localisateur du localisateur composite.

    Pour un localisateur composite avec le nouveau nom de 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. Une 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. Une 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. Voir 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.

Value Table
out_composite_address_locator

Localisateur d’adresses composite qui va être créé. ArcGIS AllSource permet uniquement d’enregistrer des localisateurs dans un dossier de fichiers.

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 seront 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.
    • La syntaxe est une chaîne de noms de localisateur séparés par une virgule.
    • Pour un localisateur composite contenant deux localisateurs (Atlanta.loc et Memphis.loc, par exemple), la syntaxe doit être "Atlanta, Memphis".
  • Order by role and score : les rôles individuels des localisateurs participants seront groupé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).
    • Pour un localisateur composite contenant deux localisateurs à plusieurs rôles (Atlanta.loc et Memphis.loc, par exemple) contenant chacun un rôle PointAddress 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.
    • Pour un localisateur composite contenant deux localisateurs à plusieurs rôles (Atlanta.loc et Memphis.loc, par exemple) 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 CreateCompositeAddressLocatorample (fenêtre Python)

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

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

# Import system modules
import arcpy 

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

# Set local variables:
US_Streets_locator = "C:/dm_stmap_dvd/streetmap_na/data/Street_Addresses_US"
Atlanta_locator = Atlanta
Atlanta_Composite = US_Atlanta_Composite

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

composite_locator_field_map = address_field_map + city_field_map + state_field_map + zip_field_map

arcpy.geocoding.CreateCompositeAddressLocator("Atlanta_locator Atlanta;US_Streets_locator US_Streets", composite_loactor_field_map,"Atlanta '\"City\" = 'Atlanta'';US_Streets #",Atlanta_Composite)