Résumé
Convertit de grandes tables locales d’adresse ou d’emplacements en points dans une classe d’entités ou comme table autonome .csv ou .xls. Cet outil utilise des localisateurs hébergés sur un portail ArcGIS Enterprise.
Remarque :
Cet outil est conçu pour fonctionner dans ArcGIS Pro 2.4 ou version ultérieure associé à un portail ArcGIS Enterprise 10.7 ou version 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 ou .xlsx)
Pour les tables .csv en entrée, la première ligne du fichier en entrée est utilisée comme noms de champ pour la table en sortie, en plus des champs ajoutés depuis le localisateur. Les noms de champ ne peuvent pas contenir d’espaces ou de caractères spécifiques (comme $ ou *).
En savoir plus sur l’utilisation des fichiers Microsoft Excel dans ArcGIS Pro
Remarque :
La façon la plus rapide de renvoyer les résultats de géocodage avec une table en entrée sous la forme d’une géodatabase fichier consiste à limiter le contenu de la géodatabase fichier, ou à fournir une géodatabase fichier contenant une seule table.
Vous pouvez géocoder des adresses qui sont stockées dans un seul champ ou dans plusieurs. Un seul champ en entrée stocke 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 en plusieurs champs comme Address, City, State et ZIP pour une adresse aux États-Unis.
Certains localisateurs prennent en charge plusieurs adresses en entrée telles que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs ; les champs d’adresse seront 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 deviendront 100 Main St Apt 140 lors du géocodage.
Cet outil exige un portail ArcGIS Enterprise 10.7 ou version ultérieure.
L’utilisation d’un localisateur sur le portail ArcGIS Enterprise configuré pour utiliser plusieurs threads améliore la performance de géocodage.
Si un localisateur de portail n’est pas disponible sur le portail, demandez à votre administrateur de portail d’ajouter le localisateur comme service utilitaire du portail et configurez le localisateur pour le géocodage par lots.
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 en sortie en définissant un système de coordonnées en sortie différent dans les paramètres d’environnement de l’outil.
Les résultats de géocodage contiendront toutes les informations de géocodage pertinentes, comme le score, le statut et l’adresse correspondante de chaque enregistrement, ainsi que les valeurs à partir de la table en entrée d’origine. Les résultats de géocodage depuis cet outil contiennent une capture d’écran statique de la table en entrée d’origine. Ainsi, l’ajout ou la mise à jour de toute valeur dans la table d’origine ne mettra pas à jour les résultats dans le fichier en sortie. Exécutez à nouveau l’outil pour créer un nouveau fichier en sortie qui contient ces changements.
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 Rematch Addresses (Ré-apparier les adresses) qui ouvre la fenêtre Rematch Addresses (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
Syntaxe
GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category})| Paramètre | Explication | Type de données |
in_table | Table en entrée qui contient des adresses ou des emplacements à géocoder au format CSV, XLS ou XLSX ou table de géodatabase fichier. | Record Set |
locator | Localisateur de portail utilisé pour géocoder la table. Une liste complète des localisateurs est disponible sur le portail actif. Vous pouvez sélectionner un localisateur depuis cette liste ou naviguer jusqu’au portail actif pour accéder aux autres localisateurs disponibles. Les localisateurs définis comme services utilitaires sur le portail actif sont disponibles par défaut. Remarque :Le ArcGIS World Geocoding Service est désactivé pour cet outil. Utilisez l’outil Géocoder des adresses si vous souhaitez utiliser le ArcGIS World Geocoding Service. | 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 d’adresses et table_field_name représente 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 stocke l’adresse complète, par exemple 303 Peachtree St NE, Atlanta, GA 30308. Sinon, vous pouvez spécifier plusieurs champs si les adresses en entrée sont réparties sur plusieurs champs comme Address, City, State et ZIP pour une adresse aux États-Unis. Certains localisateurs prennent en charge plusieurs adresses en entrée telles que Address, Address2 et Address3. Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs ; les champs d’adresse seront 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 deviendront 100 Main St Apt 140 lors du géocodage. Si vous choisissez de ne pas apparier un champ d’adresse facultatif en entrée utilisé par le localisateur d’adresses à 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 | Type de fichier dans lequel les résultats de géocodage sont écrits.
| 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écifique. 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écifique, et la nouvelle géodatabase fichier contient la classe d’entités géocodée. La géodatabase fichier en sortie et la classe d’entités de la géodatabase fichier ont le même nom. | 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 prenant en charge un paramètre de pays et limite le géocodage aux pays sélectionnés. La sélection d’un ensemble de pays contribue à accroître la précision du géocodage. Si un champ représentant des pays dans Input Table (Table en entrée) est apparié au Role: Field Name (Rôle : Nom de champ) Country, la valeur du pays dans le paramètre Input Table (Table en entrée) remplace le paramètre Country (Pays). Si aucun pays n’est spécifié, le géocodage est effectué sur tous les pays pris en charge sur le localisateur. La valeur en entrée doit être spécifiée sous forme d’un code de pays ISO 3166-1 de 3 caractères. Le paramètre Country (Pays) n’est pas pris en charge pour tous les localisateurs. | String |
location_type (Facultatif) | Spécifie la géométrie de sortie préférée des correspondances POINT_ADDRESS. Les options de ce paramètre sont ROUTING_LOCATION, le côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou ADDRESS_LOCATION, l’emplacement représentant le toit, le centroïde de parcelle de l'adresse ou la porte principale. Si l’emplacement préféré n’existe pas dans les données, l’emplacement par défaut de ROUTING_LOCATION est renvoyé à la place. 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. Reportez-vous à l’aide web de l’API REST pour obtenir de détails sur le paramètre locationType pour reverseGeocode. Ce paramètre n’est pas pris en charge pour tous les localisateurs.
| String |
category [category,...] (Facultatif) | Limite les types d’emplacements que le localisateur recherche, éliminant les correspondances faussement positives et accélérant éventuellement le processus de recherche. Si aucune catégorie n’est utilisée, le géocodage est effectué sur toutes les catégories prises en charge. Toutes les valeurs de catégories ne sont pas prises en charge pour tous les emplacements et pays. Le paramètre Category (Catégorie) peut généralement être utilisé pour les opérations suivantes :
Ce paramètre n’est pas pris en charge pour tous les localisateurs. Reportez-vous à l’aide web de l’API REST pour obtenir de détails sur le filtrage par catégorie. | String |
Sortie dérivée
| Nom | Explication | Type de données |
| out_feature_class | Classe d'entités en sortie. | Classe d’entités |
| out_table | Table en sortie au format CSV ou XLS, selon le Output Type (Type en sortie) sélectionné. | Tableau |
Exemple de code
Le script Python ci-dessous illustre l'utilisation de l'outil GeocodeFile dans un script autonome.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# Input is a local table
input_table = r"C:\data\customers.csv"
# this tool works with locators on your Portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_name>"
# The easiest way to generate a field mapping is by running the tool in ArcGIS
# Pro and 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 user selects
# FEATURE_CLASS output_type, then 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)Environnements
Informations de licence
- Basic: Requiert Privilège votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
- Standard: Requiert Privilège votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
- Advanced: Requiert Privilège votre compte dans ArcGIS Enterprise pour que vous puissiez disposer du privilège Perform Analysis (Effectuer une analyse)
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?