ArcMap

Créer un localisateur d'adresses

Résumé

Crée un localisateur d'adresses. Le localisateur d’adresses permet de trouver l’emplacement d’une adresse, de géocoder une table d’adresses ou d’obtenir l’adresse d’un emplacement ponctuel.

Pour en savoir plus sur des tâches de géocodage courantes

Utilisation

  • Les localisateurs d'adresses peuvent être créés dans tout dossier que vous désignez.

  • Le rôle d'un jeu de données de référence définit le rôle qu'il joue en tant que données de référence pour le localisateur d'adresses. Les styles de localisateur d'adresses fournis avec ArcGIS utilisent les valeurs suivantes pour décrire les rôles des jeux de données de référence :

    • Table principale - Définit la classe d'entités du jeu de données de référence principales d'un localisateur, par exemple une classe d'entités axes de rues. Cette table est obligatoire.
    • Table de nom de villes secondaires : définit une table de noms de villes secondaires qui contient des noms secondaires pour les villes ou les localités. La table est obligatoire pour avoir un JoinID pouvant être utilisé pour une liaison à la table principale. Cette table est facultative.
    • Table de nom secondaire - Définit une table de noms de rues secondaires qui contient des noms secondaires pour les rues ou les entités ponctuelles. La table est obligatoire pour avoir un JoinID pouvant être utilisé pour une liaison à la table principale. Cette table est facultative.
    • Table d'alias - Définit une table d'alias de noms d'endroits qui contient des noms de lieux et leur adresse réelle. L'utilisateur peut trouver l'emplacement à l'aide du nom de lieu, par exemple Field Museum ou de l'adresse 1400 S Lakeshore Drive Chicago, IL 60605. Cette table est facultative.

  • Les styles de localisateurs personnalisés ou les styles de localisateurs fournis par des tiers peuvent définir des rôles différents pour les classes d'entités et les tables de données de référence. Reportez-vous à leur documentation pour plus d'informations sur les rôles qu'ils définissent pour les jeux de données de référence.

  • Les localisateurs d'adresses composites ne peuvent pas être créés à l'aide de cet outil. Utilisez l’outil Créer un localisateur d'adresses composite pour créer un localisateur d’adresses composite.

Syntaxe

arcpy.geocoding.CreateAddressLocator(in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})
ParamètreExplicationType de données
in_address_locator_style

Style de localisateur d'adresses servant de base au nouveau localisateur d'adresses.

  • US Address-Dual Ranges—À utiliser lorsque les données de référence sont une classe d’entités linéaires contenant des plages de numéros de maisons des deux côtés d’un segment de rue et que vous voulez rechercher une adresse portant sur un côté spécifique d’une rue ou d’une intersection de rues.
  • US Address-One Range—À utiliser lorsque les données de référence sont une classe d’entités linéaires contenant une plage de numéros de maisons pour chaque segment de route et que vous voulez rechercher une adresse (la mention du côté est inutile) ou une intersection de rues.
  • US Address-Single House—À utiliser lorsque les données de référence sont une classe d’entités ponctuelles ou surfaciques pour laquelle chaque entité représente une adresse unique et que vous voulez rechercher l’adresse exacte d’une parcelle, d’un bâtiment ou d’un point d’adresse.
  • US Address-Single House Subaddress—À utiliser lorsque les données de référence sont une classe d’entités ponctuelles ou surfaciques pour laquelle chaque entité représente une adresse unique avec des éléments de sous-adresse facultatifs et que vous voulez rechercher des identifiants d’appartements, de maisons de ville, de duplex ou de magasins dans un centre commercial.
  • US Address-Street Name—À utiliser lorsque les données de référence sont une classe d’entités linéaires et que vous voulez rechercher des adresses à l’aide du nom de rue uniquement. Les informations concernant la plage d’adresses ne sont pas nécessaires.
  • US Address-City State—À utiliser lorsque les données de référence sont une classe d’entités ponctuelles ou surfaciques et que vous voulez rechercher une ville spécifique dans un État.
  • US Address-ZIP 5 Digit—À utiliser lorsque les données de référence sont une classe d’entités ponctuelles ou surfaciques pour laquelle chaque entité représente un centroïde de code postal ou une zone géographique et que vous voulez rechercher un emplacement de code postal.
  • General-Gazetteer—À utiliser lorsque les données de référence sont une classe d’entités ponctuelles ou surfaciques pour laquelle chaque entité représente une entité unique et que vous voulez rechercher un nom de lieu, un point de repère, un compteur d’eau ou une valeur unique.
Address Locator Style
in_reference_data
[[Reference Data, {Role}],...]

Tables et classes d'entités des données de référence à utiliser par le localisateur d'adresses, avec leurs rôles.

  • Table principale - Définit la classe d'entités du jeu de données de référence principales d'un localisateur, par exemple une classe d'entités axes de rues. Cette table est obligatoire.
  • Table de nom de villes secondaires : définit une table de noms de villes secondaires qui contient des noms secondaires pour les villes ou les localités. La table est obligatoire pour avoir un JoinID pouvant être utilisé pour une liaison à la table principale. Cette table est facultative.
  • Table de nom secondaire - Définit une table de noms de rues secondaires qui contient des noms secondaires pour les rues ou les entités ponctuelles. La table est obligatoire pour avoir un JoinID pouvant être utilisé pour une liaison à la table principale. Cette table est facultative.
  • Table d'alias - Définit une table d'alias de noms d'endroits qui contient des noms de lieux et leur adresse réelle. L'utilisateur peut trouver l'emplacement à l'aide du nom de lieu, par exemple Field Museum ou de l'adresse 1400 S Lakeshore Drive Chicago, IL 60605. Cette table est facultative.

Les styles de localisateurs personnalisés ou les styles de localisateurs fournis par des tiers peuvent définir un jeu de rôles différent pour les jeux de données de référence.

Value Table
in_field_map

Mappage des champs de données de référence utilisés par le style de localisateur d'adresses avec les champs contenus dans les jeux de données de référence. Chaque mappage de champ de ce paramètre est au format :

# <locator field alias> <dataset field name> VISIBLE NONE

# This shows as an example:
reference_data_field_map = """
"'Feature ID' FeatureID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;
'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;
'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;
'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;
'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE"""

où <alias de champ du localisateur> est le nom de l'alias du champ de données de référence utilisé par le localisateur d'adresses et <nom de champ du jeu de données> est le nom de champ du jeu de données de référence. Les champs signalés par un astérisque (*) en regard de leur nom sont requis par le style de localisateur d’adresses.

VISIBLE : le champ est visible ; NONE : la géométrie est une copie de la valeur d'origine.

Si vous choisissez de ne pas apparier un champ de données de référence facultatif utilisé par le style 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 "<Aucun>" au lieu d'un nom de champ.

Field Info
out_address_locator

Localisateur d’adresses à créer. L’enregistrement du localisateur dans un dossier permet de bénéficier des avantages liés à l’amélioration des performances, aux fonctions de multithreading et à la prise en charge des suggestions. Une fois un localisateur créé, les propriétés supplémentaires et les options peuvent être modifiées dans les paramètres du localisateur.

Address Locator
config_keyword
(Facultatif)

Mot-clé de configuration qui détermine les paramètres de stockage de la table dans un système de gestion de base de données relationnelles (SGBDR) : géodatabases d'entreprise et fichier uniquement.

String
enable_suggestions
(Facultatif)

Permet de générer des suggestions automatiques caractère par caractère lors de la saisie de données dans une application client. Cette fonctionnalité facilite les recherches interactives de l'utilisateur, car il lui suffit d'entrer quelques caractères uniquement pour obtenir une suggestion correspondante. L'idée est de permettre à une application client de fournir une liste de suggestions qui est mise à jour à chaque fois qu'un utilisateur entre un caractère, jusqu'à ce que la liste renvoie le lieu qu'il recherche.

Seuls les styles de localisateurs fournis par Esri peuvent être utilisés pour créer des localisateurs avec des suggestions activées. La fonctionnalité de suggestion n'est affichée que lorsque ce type de localisateur est publié en tant que service de géocodage. Les localisateurs pour lesquels des suggestions sont activées peuvent uniquement être enregistrés dans un dossier de fichiers. Ils ne peuvent pas être enregistrés dans une géodatabase.

  • ENABLED —Les suggestions sont activées pour le localisateur.
  • DISABLED —Les suggestions sont désactivées pour le localisateur. Il s’agit de l’option par défaut.
Boolean

Exemple de code

Exemple d'utilisation du script Créer un localisateur d'adresses (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CreateAddressLocator.

# Create a street address locator using a street centerline feature class 
# in a file geodatabase as reference data.
# The new address locator will be created in a separate file folder.

# Import system modules
import arcpy

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

arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets 'Primary Table'", "'Feature ID' OBJECTID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left ZIP Code' ZIPL VISIBLE NONE;'Right ZIP Code' ZIPR VISIBLE NONE;'Left State' STATE_ABBR VISIBLE NONE;'Right State' STATE_ABBR VISIBLE NONE", Atlanta_AddressLocator_OutputPath, "", "DISABLED")

Environnements

Informations de licence

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

Rubriques connexes