Géocoder un fichier (Géocodage)

Synthèse

Convertit d’importantes tables locales d’adresses ou de lieux en points dans une classe d’entités ou en tant que table CSV ou XLS. Cet outil utilise des localisateurs hébergés sur un portail ArcGIS Enterprise.

Remarque :

Cet outil fonctionne dans ArcGIS AllSource version 2.4 ou ultérieure avec un portail ArcGIS Enterprise version 10.7 ou ultérieure.

Utilisation

  • Cet outil prend en charge les formats tabulaires suivants en entrée :

    • Valeurs séparées par des virgules (.csv)
    • Tables de géodatabase fichier
    • Feuilles de calcul Microsoft Excel (fichiers .xls et .xlsx)

    Pour les tables CSV en entrée, le contenu de la première ligne du fichier en entrée est utilisé comme noms de champ pour la table en sortie, en plus des champs ajoutés à partir du localisateur. Les noms de champ ne peuvent pas contenir d’espaces ou de caractères spéciaux tels que $ ou *.

    En savoir plus sur l’utilisation de fichiers Microsoft Excel dans ArcGIS AllSource

    Remarque :

    Les méthodes les plus rapides pour obtenir des résultats de géocodage avec une table en entrée sous forme de géodatabase fichier consistent à limiter le contenu de la géodatabase fichier ou à fournir une géodatabase fichier qui contient une seule table.

  • Vous pouvez géocoder des adresses qui sont stockées dans un seul champ ou réparties sur plusieurs champs, ou stockées dans un seul champ et dans un champ de pays. Un champ unique en entrée contient l’adresse complète, par exemple 303 Peachtree St NE, Atlanta, GA 30308. Plusieurs champs sont pris en charge si les adresses en entrée sont réparties sur plusieurs champs, tels que Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Un seul champ en entrée contient l’adresse complète, par exemple 303 Peachtree St NE, Atlanta, GA 30308. Un champ qui stocke le pays associé à l’adresse, par exemple, États-Unis, est également pris en charge.

  • Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée tels que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse sont concaténés au moment du géocodage. Par exemple, 100, Main St et Apt 140 en trois champs ou 100 Main st et Apt 140 constituant deux champs 100 Main st Apt 140 lors du géocodage

  • Un portail ArcGIS Enterprise 10.7 ou version ultérieure est nécessaire pour utiliser cet outil.

  • Si un localisateur de portail n’est pas disponible comme service utilitaire sur le portail, contactez l’administrateur du portail pour qu’il ajoute ce localisateur en tant que service utilitaire du portail et configurez le localisateur pour le géocodage par lots.

  • Utilisez un localisateur sur le portail ArcGIS Enterprise qui a été configuré pour utiliser plusieurs threads pour améliorer les performances de géocodage.

  • Les résultats de géocodage sont enregistrés dans la même référence spatiale que le localisateur. Vous pouvez modifier la référence spatiale de la sortie en définissant un système de coordonnées en sortie dans les paramètres d’environnement de l’outil.

  • Les résultats de géocodage contiendront toutes les informations de géocodage appropriées, telles que le score, le statut et l’adresse appariée de chaque enregistrement, ainsi que les valeurs de la table d’origine en entrée. Les résultats de géocodage produits par cet outil comprennent un instantané statique de la table d’origine en entrée. Par conséquent, l’ajout ou la mise à jour des valeurs dans la table d’origine n’implique pas la mise à jour des résultats dans le fichier en sortie. Réexécutez l’outil pour créer un fichier en sortie qui inclut ces modifications.

  • Lorsque les résultats de géocodage sont renvoyés sous forme de classe d’entités, les adresses peuvent être réappariées à l’aide de l’outil Réapparier les adresses ou de l’option Réapparier les adresses qui ouvre la fenêtre Réapparier les adresses.

    Remarque :

    La table doit être géocodée par un localisateur figurant dans le portail ArcGIS Enterprise 10.8 qui comporte plusieurs threads en vue du géocodage par lots.

    Pour en savoir plus sur le ré-appariement des résultats de géocodage

  • Lorsqu’un localisateur créé avec des données de type z est utilisé en entrée, l’outil renvoie une sortie qui n’est pas de type z. Seule les sorties 2D sont prises en charge dans cet outil.

  • L’outil n’applique pas les configurations à partir d’une vue de localisateur créée dans ArcGIS Pro 3.2 lorsqu’il l’utilise comme valeur du paramètre Localisateur.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

Table en entrée qui contient les adresses ou les lieux à géocoder au format CSV, XLS ou XLSX ou dans une table de géodatabase fichier.

Record Set
Localisateur

Localisateur du portail utilisé pour géocoder la table.

Vous pouvez choisir un localisateur dans la liste des localisateurs sur le portail actif ou y rechercher d’autres localisateurs disponibles. Les localisateurs qui ont été définis en tant que services utilitaires sur le portail actif sont disponibles par défaut.

Remarque :

Le service ArcGIS World Geocoding Service est désactivé pour cet outil. Pour utiliser ArcGIS World Geocoding Service, servez-vous de l’outil Géocoder des adresses.

Address Locator
Appariement de champs d'adresse

Les champs d’adresses utilisés par le localisateur sont appariés avec les champs de la table d’adresses en entrée. Spécifiez Champ unique si l’adresse complète est stockée dans un champ de la table en entrée, par exemple, 303 Peachtree St NE, Atlanta, GA 30308. Spécifiez Champs multiples si les adresses en entrée sont divisées en plusieurs champs, tels que Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Spécifiez Champ unique et champ de pays si l’adresse complète, comme, 303 Peachtree St NE, Atlanta, GA 30308, et le pays, comme États-Unis, sont répartis sur des champs distincts, tels que Address et Country.

Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée tels que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et les champs d’adresse sont concaténés au moment du géocodage. Par exemple, 100, Main St et Apt 140 en trois champs ou 100 Main st et Apt 140 constituant deux champs 100 Main st Apt 140 lors du géocodage.

Si vous n’appariez pas un champ d’adresse facultatif en entrée utilisé par le localisateur à un champ dans la table d’adresses en entrée, précisez qu’il n’y a pas d’appariement en utilisant <None> (<Aucun>) au lieu d’un nom de champ.

Field Info
Type en sortie

Spécifie le type de fichier dans lequel les résultats de géocodage seront enregistrés.

  • CSVUn fichier .csv sera renvoyé.
  • Classe d’entitésUne classe d’entités au sein d’une géodatabase fichier sera renvoyée.
  • XLSUn fichier .xls sera renvoyé.
String
Emplacement en sortie

Dossier dans lequel les résultats de géocodage en sortie sont écrits.

Si la sortie est un fichier .csv ou .xls, un fichier en sortie est placé dans le dossier spécifié.

Si la sortie est une classe d’entités, une géodatabase fichier en sortie est créée et placée dans le dossier spécifié. La nouvelle géodatabase fichier contient alors la classe d’entités géocodées. La géodatabase fichier en sortie porte le même nom que la classe d’entités dans la géodatabase fichier.

Workspace
Nom en sortie

Nom des résultats géocodés en sortie.

String
Pays
(Facultatif)

Pays dans lesquels les adresses géocodées sont recherchées.

Ce paramètre est disponible pour les localisateurs qui prennent en charge un paramètre de pays et limitera le géocodage aux pays indiqués. L’indication d’un pays contribue à accroître la précision du géocodage. Lorsque vous spécifiez Champ unique et champ de pays dans le paramètre Appariement de champs d’adresse et que vous appariez un champ représentant les pays dans la valeur du paramètre Table en entrée au champ Country dans le paramètre Appariement de champs d’adresse, la valeur du pays issue du paramètre Table en entrée remplace celle du paramètre Pays.

Limite l’opération aux pays indiqués. Dans le cas où aucun pays n’est indiqué, le géocodage est effectué pour tous les pays pris en charge par le localisateur.

Le paramètre Country (Pays) n’est pas pris en charge pour tous les localisateurs.

String
Type de localisation préféré
(Facultatif)

Spécifie la géométrie en sortie de votre choix allant être renvoyée pour les correspondances PointAddress. Les options de ce paramètre sont Routing location (Emplacement d’itinéraire), le côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou Address location (Emplacement d’adresse), l’emplacement représentant le toit ou le centroïde de parcelle de l’adresse. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut est renvoyé. Pour les résultats de géocodage avec Addr_type=PointAddress, les valeurs attributaires x,y décrivent les coordonnées de l’adresse le long de la rue, tandis que les valeurs DisplayX et DisplayY décrivent les coordonnées du toit ou du centroïde du bâtiment.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • Localisation d’adresseLa géométrie des résultats de géocodage qui représentent une localisation d’adresse, comme le toit, le centroïde de la parcelle ou la porte principale, est renvoyée.
  • Localisation d’itinéraireLa géométrie des résultats de géocodage représentant un emplacement proche du côté de la rue qui peut servir dans le cadre du calcul d’itinéraire est renvoyé. Il s’agit de l’option par défaut.
String
Catégorie
(Facultatif)

Restreint les types de lieux que le localisateur recherche, ce qui élimine les correspondances positives erronées et peut accélérer le processus de recherche. Si aucune catégorie n’est utilisée, le géocodage est effectué pour toutes les catégories prises en charge. Toutes les valeurs de catégorie ne sont pas prises en charge pour tous les emplacements et tous les pays. Ce paramètre peut généralement être utilisé pour les opérations suivantes :

  • Restreindre les correspondances à des types de lieux ou à des niveaux d'adresse spécifiques
  • Éviter les correspondances de remplacement pour les niveaux d'adresse non désirés
  • Différencier les recherches de coordonnées

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

String
Champs en sortie
(Facultatif)

Spécifie les champs de localisateur en sortie qui sont renvoyés dans les résultats de géocodage.

  • ToutInclut tous les champs de localisateur en sortie disponibles dans les résultats de géocodage. Il s’agit de l’option par défaut.
  • Emplacement uniquementLe champ Shape est stocké si le résultat du géocodage est une classe d’entités. Les champs Shape X et Shape Y sont stockés si le résultat est un fichier .csv ou .xls. Les noms de champ d’origine du paramètre Table en entrée sont conservés.
  • MinimaleAjoute les champs suivants qui décrivent l’emplacement et son niveau d’appariement avec les informations du localisateur dans les résultats de géocodage : Shape, Status, Score, Match_type, Match_addr et Addr_type. Les noms de champ d’origine de la valeur du paramètre Table en entrée sont conservés.
  • Champs minimaux et d’utilisateurAjoute les champs suivants qui décrivent la localisation et leur pertinence par rapport aux informations du localisateur, ainsi que les champs en sortie personnalisés définis par l’utilisateur dans les résultats de géocodage : Shape, Status, Score, Match_type, Match_addr et Addr_type. Les noms de champ d’origine de la valeur du paramètre Table en entrée sont conservés.
Remarque :

Ce paramètre peut être utilisé avec des localisateurs en entrée créés à l’aide de l’outil Créer un localisateur ou Créer un localisateur d’entités publié dans Enterprise 10.9 ou version ultérieure. Les localisateurs composites qui contiennent au moins un localisateur créé à l’aide de l’outil Créer un localisateur d’adresses ne prennent pas en charge ce paramètre.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Classe d’entités en sortie.

Feature Class
Table en sortie

Table en sortie au format CSV ou XLS, en fonction de la valeur du paramètre Output Type (Type en sortie).

Table

arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})
NomExplicationType de données
in_table

Table en entrée qui contient les adresses ou les lieux à géocoder au format CSV, XLS ou XLSX ou dans une table de géodatabase fichier.

Record Set
locator

Localisateur du portail utilisé pour géocoder la table.

Vous pouvez choisir un localisateur dans la liste des localisateurs sur le portail actif ou y rechercher d’autres localisateurs disponibles. Les localisateurs qui ont été définis en tant que services utilitaires sur le portail actif sont disponibles par défaut.

Remarque :

Le service ArcGIS World Geocoding Service est désactivé pour cet outil. Pour utiliser ArcGIS World Geocoding Service, servez-vous de l’outil Géocoder des adresses.

Address Locator
address_fields

Chaque appariement de champ dans ce paramètre est au format input_locator_field, table_field_name, où input_locator_field désigne le nom du champ d’adresse en entrée spécifié par le localisateur et table_field_name le nom du champ correspondant dans la table d’adresses que vous souhaitez géocoder.

Vous pouvez spécifier un seul champ en entrée qui contient l’adresse complète, par exemple, 303 Peachtree St NE, Atlanta, GA 30308. Vous pouvez également spécifier plusieurs champs si les adresses en entrée sont décomposées dans plusieurs champs, tels que Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Vous pouvez également spécifier un seul champ en entrée qui stocke l’adresse complète, par exemple, 303 Peachtree St NE, Atlanta, GA 30308, et un champ qui stocke le pays associé à l’adresse, par exemple, États-Unis.

Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée tels que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs ; les champs d’adresse sont concaténés au moment du géocodage. Par exemple, 100, Main St et Apt 140 en trois champs ou 100 Main st et Apt 140 constituant deux champs 100 Main st Apt 140 lors du géocodage.

Si vous n’appariez pas un champ d’adresse facultatif en entrée utilisé par le localisateur à un champ dans la table d’adresses en entrée, précisez qu’il n’y a pas d’appariement en utilisant <None> au lieu d’un nom de champ.

Field Info
output_type

Spécifie le type de fichier dans lequel les résultats de géocodage seront enregistrés.

  • CSVUn fichier .csv sera renvoyé.
  • FEATURE_CLASSUne classe d’entités au sein d’une géodatabase fichier sera renvoyée.
  • XLSUn fichier .xls sera renvoyé.
String
output_location

Dossier dans lequel les résultats de géocodage en sortie sont écrits.

Si la sortie est un fichier .csv ou .xls, un fichier en sortie est placé dans le dossier spécifié.

Si la sortie est une classe d’entités, une géodatabase fichier en sortie est créée et placée dans le dossier spécifié. La nouvelle géodatabase fichier contient alors la classe d’entités géocodées. La géodatabase fichier en sortie porte le même nom que la classe d’entités dans la géodatabase fichier.

Workspace
output_name

Nom des résultats géocodés en sortie.

String
country
[country,...]
(Facultatif)

Pays dans lesquels les adresses géocodées sont recherchées.

Ce paramètre est disponible pour les localisateurs qui prennent en charge un paramètre de pays et limitera le géocodage aux pays indiqués. L’indication d’un pays contribue à accroître la précision du géocodage. Si un champ représentant les pays dans le paramètre in_table est apparié au champ Country dans address_fields, la valeur du pays du paramètre in_table remplace celle du paramètre country.

Limite l’opération aux pays indiqués. Si aucun pays n’est spécifié, le géocodage est effectué pour tous les pays pris en charge par le localisateur.

Indiquez la valeur sous la forme d’une liste de codes de pays à 2 ou 3 caractères séparés par des virgules. Reportez-vous à la colonne des codes de pays pris en charge pour connaître la valeur en entrée à utiliser.

Le paramètre country n’est pas pris en charge pour tous les localisateurs.

String
location_type
(Facultatif)

Spécifie la géométrie en sortie de votre choix allant être renvoyée pour les correspondances POINT_ADDRESS. Les options de ce paramètre sont ROUTING_LOCATION, ce qui correspond au côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou ADDRESS_LOCATION, c’est-à-dire l’emplacement représentant le toit, le centroïde de parcelle de l’adresse ou la porte principale. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut ROUTING_LOCATION est renvoyé. Pour les résultats de géocodage avec Addr_type=PointAddress, les valeurs attributaires x,y décrivent les coordonnées de l’adresse le long de la rue, tandis que les valeurs DisplayX et DisplayY décrivent les coordonnées du toit ou du centroïde du bâtiment. Voir l’aide Web de ArcGIS REST API pour en savoir plus sur le paramètre locationType pour geocodeAddresses.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • ADDRESS_LOCATIONLa géométrie des résultats de géocodage qui représentent une localisation d’adresse, comme le toit, le centroïde de la parcelle ou la porte principale, est renvoyée.
  • ROUTING_LOCATIONLa géométrie des résultats de géocodage représentant un emplacement proche du côté de la rue qui peut servir dans le cadre du calcul d’itinéraire est renvoyé. Il s’agit de l’option par défaut.
String
category
[category,...]
(Facultatif)

Restreint les types de lieux que le localisateur recherche, ce qui élimine les correspondances positives erronées et peut accélérer le processus de recherche. Si aucune catégorie n’est utilisée, le géocodage est effectué pour toutes les catégories prises en charge. Toutes les valeurs de catégorie ne sont pas prises en charge pour tous les emplacements et tous les pays. Ce paramètre peut généralement être utilisé pour les opérations suivantes :

  • Restreindre les correspondances à des types de lieux ou à des niveaux d'adresse spécifiques
  • Éviter les correspondances de remplacement pour les niveaux d'adresse non désirés
  • Différencier les recherches de coordonnées

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

Consultez l’aide Web de ArcGIS REST API pour en savoir plus sur le filtrage des catégories.

String
output_fields
(Facultatif)

Spécifie les champs de localisateur en sortie qui sont renvoyés dans les résultats de géocodage.

Remarque :

Ce paramètre peut être utilisé avec des localisateurs en entrée créés à l’aide de l’outil Créer un localisateur ou Créer un localisateur d’entités publié dans Enterprise 10.9 ou version ultérieure. Les localisateurs composites qui contiennent au moins un localisateur créé à l’aide de l’outil Créer un localisateur d’adresses ne prennent pas en charge ce paramètre.

  • ALLInclut tous les champs de localisateur en sortie disponibles dans les résultats de géocodage. Il s’agit de l’option par défaut.
  • LOCATION_ONLYLe champ Shape est stocké si le résultat du géocodage est une classe d’entités. Les champs Shape X et Shape Y sont stockés si le résultat est un fichier .csv ou .xls. Les noms de champ d’origine du paramètre in_table sont conservés.
  • MINIMALAjoute les champs suivants qui décrivent l’emplacement et son niveau d’appariement avec les informations du localisateur dans les résultats de géocodage : Shape, Status, Score, Match_type, Match_addr et Addr_type. Les noms de champ d’origine de la valeur du paramètre in_table sont conservés.
  • MINIMAL_AND_USERAjoute les champs suivants qui décrivent la localisation et leur pertinence par rapport aux informations du localisateur dans les résultats de géocodage, ainsi que les champs en sortie personnalisés définis par l’utilisateur : Shape, Status, Score, Match_type, Match_addr et Addr_type. Les noms de champ d’origine de la valeur du paramètre in_table sont conservés.
String

Sortie obtenue

NomExplicationType de données
out_feature_class

Classe d’entités en sortie.

Feature Class
out_table

Table en sortie au format CSV ou XLS, en fonction de la valeur du paramètre Output Type (Type en sortie).

Table

Exemple de code

Exemple d’utilisation de l’outil GeocodeFile (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction GeocodeFile dans un script autonome.

Remarque :
Si vous utilisez des localisateurs sur votre portail, assurez-vous d’être connecté à celui-ci et de l’avoir défini comme portail actif dans ArcGIS AllSource. Pour accéder à un localisateur situé sur un portail qui n’est pas le portail actif, authentifiez-vous à l’aide de la fonction SignInToPortal.

import arcpy

# Input is a local table
input_table = r"C:\data\customers.csv"

# This tool works with locators on a portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_name>"

# The best way to generate a field mapping is to run the tool in ArcGIS 
# Pro, right-click the green success ribbon, and click "Copy Python command"

field_mapping = "'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;Neighborhood <None> VISIBLE NONE;
City <None> VISIBLE NONE;County <None> VISIBLE NONE;State <None> VISIBLE NONE;ZIP ZIP VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"

# Output folder for the output CSV, Excel, or GDB table. If you select 
# FEATURE_CLASS output_type, a new GDB will be created in the 
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the 
# in_locator that you use.
country = None
location_type = "ROUTING_LOCATION"
category = "'Street Address'"

arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type, 
                            output_folder, output_name, country, location_type, 
                            category)