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

Synthèse

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

En savoir plus sur les localisateurs composites

Utilisation

  • Avant de créer des localisateurs composites, utilisez l’outil Créer un localisateur ou Créer un localisateur d’entités pour créer des localisateurs participants.

  • La référence spatiale pour un localisateur composite est indispensable. La référence spatiale du premier localisateur participant est utilisée si vous ne précisez pas de système de coordonnées en sortie différent dans les paramètres d’environnement de l’outil.

  • Utilisez l’option Ordre par rôle et score du paramètre Ordre des résultats pour un localisateur à plusieurs rôles, un localisateur ArcGIS StreetMap Premium (par exemple) et plusieurs localisateurs à rôle unique. Cela permet de trier les localisateurs et rôles dans un ordre de remplacement optimal.

  • Pour générer la syntaxe Python appropriée au paramètre in_result_ordering, exécutez d’abord l’outil depuis la fenêtre Géotraitement à l’aide de l’option adéquate du paramètre Ordre des résultats. Ouvrez ensuite le menu Exécuter et sélectionnez Copier la commande Python.

Paramètres

ÉtiquetteExplicationType de données
Localisateurs d’adresses

Localisateurs qui serviront à créer le localisateur composite. L’ordre des localisateurs participants détermine la façon dont les candidats sont recherchés et dont un lieu ou une adresse sont appariés. Lorsque vous géocodez un lieu ou une adresse unique, ils sont appariés avec tous les localisateurs participants si le localisateur n’est pas spécifié avec un critère de sélection. Tous les candidats trouvés s’affichent dans l’ordre des localisateurs participants répertoriés. Si vous géocodez une table d’adresses ou de lieux, les adresses ou les lieux sont appariés automatiquement au premier meilleur candidat trouvé dans les premiers localisateurs participants. Si l’adresse ou le lieu ne peuvent pas être appariés, ils reviennent au 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 le localisateur composite fait référence. N’utilisez pas d’espaces ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères.

Value Table
Appariement des champs

Appariement de champs en entrée utilisés par chaque localisateur participant avec les champs en entrée du localisateur composite.

Cela inclut les champs et le contenu des champs qui sont générés par les localisateurs participants. Chaque champ en entrée unique est répertorié dans le paramètre Appariement de champ. À gauche de la colonne 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 voir les champs de chaque localisateur participant qui lui sont appariés sous les colonnes Sous-champ et Propriétés. Ces champs sont les champs en entrée du localisateur composite.

Attention :

Ne supprimez aucun champ de localisateur du paramètre Appariement de champ. Un localisateur composite créé sans tous les champs de localisateur n’est pas valide.

Field Mappings
Critères de sélection
(Facultatif)

Critères de sélection pour 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 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 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 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 avec ce localisateur.

Pour spécifier un critère de sélection, cochez la case du localisateur sous la colonne 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 Plus pour ouvrir la boîte de dialogue Spécifier les critères de sélection du localisateur et définir les critères.

Value Table
Localisateur d’adresses composite en sortie

Nom du localisateur d’adresses composite qui est 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 appariées afin d’accroître la probabilité d’identification du meilleur appariement lors du géocodage.

  • Utiliser l’ordre des localisateurs : 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.
  • Ordre par rôle et score : les localisateurs participants sont regroupés par rôle et ordre de remplacement.
  • Ordre personnalisé : un ordre de remplacement personnalisable pour les localisateurs participants est utilisé pour vous permettre d’insérer des localisateurs entre les rôles d’un localisateur multirôle.
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 serviront à créer le localisateur composite. L’ordre des localisateurs participants détermine la façon dont les candidats sont recherchés et dont un lieu ou une adresse sont appariés. Lorsque vous géocodez un lieu ou une adresse unique, ils sont appariés avec tous les localisateurs participants si le localisateur n’est pas spécifié avec un critère de sélection. Tous les candidats trouvés s’affichent dans l’ordre des localisateurs participants répertoriés. Si vous géocodez une table d’adresses ou de lieux, les adresses ou les lieux sont appariés automatiquement au premier meilleur candidat trouvé dans les premiers localisateurs participants. Si l’adresse ou le lieu ne peuvent pas être appariés, ils reviennent au 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 le localisateur composite fait référence. N’utilisez pas d’espaces ou de symboles spéciaux dans le nom. Sa longueur maximale est de 14 caractères.

Value Table
in_field_map

Appariement de champs en entrée utilisés par chaque localisateur participant avec les champs en entrée du localisateur d'adresses composite.

Pour chaque champ en entrée du localisateur, formatez les informations de champ comme dans cette chaîne d’exemple : "Address 'Address or Intersection' true true false 4 Text 0 0 ,First,'#',Street". Les informations de cette chaîne se composent des éléments suivants :

  • Nom du nouveau champ (Address) : le nom du nouveau champ du localisateur composite.

    Un localisateur du composite peut avoir un champ Address et l’autre localisateur peut avoir un champ Street Address. Vous pouvez désigner le nouveau champ du localisateur composite comme Address, ce qui référence les champs des deux localisateurs d’origine.

  • Alias du nom du nouveau champ ('Address or Intersection') : l’alias du nom du nouveau champ du localisateur composite.

    Pour un localisateur composite avec le nom du nouveau champ Address, vous pouvez désigner un alias 'Address or Intersection' pour le champ.

  • EstModifiable (true) : indique si le nouveau champ du localisateur composite est modifiable. Les options sont true ou false.
  • Autoriser les valeurs nulles (true) : indique si le nouveau champ du localisateur composite autorise les valeurs nulles. Les options sont true ou false.
  • Obligatoire (false) : indique si le nouveau champ du localisateur composite est un champ obligatoire. Les options sont true ou false.
  • Longueur (4) : la longueur du nouveau champ du localisateur composite.
  • Type (Text) : le type de données du nouveau champ du localisateur composite. Cette valeur doit toujours être Text pour un localisateur.
  • Échelle (0) : l’échelle du nouveau champ du localisateur composite. Vous pouvez utiliser toute valeur comprise entre 1 et 100. Cette valeur ne s’applique pas aux localisateurs, mais une valeur valide doit être utilisée.
  • Précision (0) : la précision du nouveau champ du localisateur composite. Vous pouvez utiliser toute valeur comprise entre 1 et 100. Cette valeur ne s’applique pas aux localisateurs, mais une valeur valide doit être utilisée.
  • Règle de combinaison (First) : la règle de combinaison du nouveau champ du localisateur composite. Toute 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 du nouveau champ du localisateur composite. Tout délimiteur pris en charge peut être utilisé.
  • Nom de champ du localisateur d’origine (Street) : le nom de champ du localisateur dans le localisateur participant d’origine.
Field Mappings
in_selection_criteria
[[in_address_locator, selection_criteria],...]
(Facultatif)

Critères de sélection pour 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 pour une adresse ou un lieu en particulier afin d’augmenter l’efficacité du processus de géocodage. Consultez Concepts de la combinaison de plusieurs localisateurs pour créer 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

Nom du localisateur d’adresses composite qui est 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 appariées afin d’accroître la probabilité d’identification du meilleur appariement 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.
    • 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 localisateurs participants sont regroupés par rôle et ordre de remplacement.
    • La syntaxe est une chaîne de regroupements de rôles séparés par des virgules, dont la structure est [LocatorRole1](LocatorName1.LocatorRole1, LocatorName2.LocatorRole1).
    • Pour un localisateur composite contenant deux localisateurs multirôles (Atlanta.loc et Memphis.loc, par exemple) chacun contenant un rôle PointAddress et un rôle StreetAddress, la syntaxe doit être "[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)".
    • L’ordre des rôles doit être du plus précis au moins précis.
  • Custom order : un ordre de remplacement personnalisable pour les localisateurs participants est utilisé pour vous permettre d’insérer des localisateurs entre les rôles d’un localisateur multirôle.
    • La syntaxe est une chaîne de noms et de rôles de localisateurs séparés par des virgules, dont la structure est LocatorName.LocatorRole.
    • Pour un localisateur composite contenant deux localisateurs multirôles (Atlanta.loc et Memphis.loc, par exemple) chacun contenant 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 positionnés dans n’importe quel ordre, mais placer des rôles moins précis avant des rôles plus précis peut entraîner un comportement inattendu.

Pour générer la syntaxe Python appropriée, exécutez d’abord l’outil depuis la fenêtre Géotraitement. Ouvrez ensuite le menu Exécuter et sélectionnez Copier la commande Python.

String

Exemple de code

Exemple CreateCompositeAddressLocator (fenêtre Python)

Le script ci-dessous pour la fenêtre Python 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)

Informations de licence

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

Rubriques connexes