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

Synthèse

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

En savoir plus sur les localisateurs composites

Utilisation

  • Avant de créer des localisateurs d’adresses composite, utilisez l’outil Créer un localisateur pour créer des localisateurs d’adresses participants.

  • La référence spatiale pour un localisateur d'adresses composite est indispensable. La référence spatiale du premier localisateur d’adresses 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.

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 par rapport à 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.

Les champs et le contenu des champs qui sont créés par les localisateurs participants. Chacun des champs uniques en entrée est répertorié dans la section Appariement de champ. Lorsque vous développez la section, la liste de toutes les occurrences de champs en entrée (sous-champs) pour chaque localisateur d’adresses participant s’affiche. Ces champs sont les champs en entrée pour le localisateur d'adresses composite. S'il existe des champs en double tels que ZIP et Postcode en raison du renseignement des noms uniques provenant des localisateurs d’adresses participants, vous pouvez grouper les sous-champs en les faisant glisser vers le champ correspondant ou utiliser le bouton Flèche vers le haut ou Flèche vers le bas pour déplacer le sous-champ.

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 d’adresses composite, vous pouvez spécifier les localisateurs d’adresses utilisés en fonction des valeurs des champs des adresses en entrée. Par exemple, si le localisateur d’adresses 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 d’adresses participants qui ne répondent pas aux critères pour 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

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator)
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 par rapport à 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, les informations de champ doivent être formatées 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.

  • isEditable (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 d'adresses participant.

L’utilisation de critères de sélection disqualifie les localisateurs d’adresses 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

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.CreateCompositeAddressLocator_geocoding("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