Géocoder des emplacements à partir d’une table (Outils de géocodage)

Résumé

Utilise des localisateurs hébergés sur un portail ArcGIS Enterprise pour géocoder des tables hébergées, ce qui génère une couche d’entités hébergée contenant les résultats géocodés.

Cet outil automatise le processus de géocodage des tables publiées sur le portail et enregistre la sortie sur le portail. S’il est inutile d’enregistrer les résultats du géocodage sur le portail, utilisez la fenêtre Geocode Table (Géocoder une table) ou l’outil Geocode Addresses (Géocoder des adresses).

Remarque :

Vous devez détenir des privilèges d’éditeur ou d’administrateur sur le portail pour exécuter cet outil. Si vous détenez un rôle personnalisé, assurez-vous que l’administrateur du portail vous a accordé le privilège Publish hosted web layers (Publier des couches Web hébergées).

Utilisation

Vous pouvez géocoder des adresses stockées dans un seul champ, réparties sur plusieurs champs ou dans un seul champ et 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 stocke l’adresse complète (303 Peachtree St NE, Atlanta, GA 30308, par exemple) et un champ qui stocke le pays associé à l’adresse (USA, par exemple) est également pris en charge.
Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée (Address, Address2 et Address3, par exemple). Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et 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 en deux champs deviennent 100 Main St Apt 140 lors du géocodage.
ArcGIS Enterprise 10.6 ou version ultérieure est nécessaire pour utiliser cet outil.
Utilisez un localisateur sur le portail ArcGIS Enterprise qui a été configuré pour utiliser plusieurs threads pour améliorer les performances de géocodage.
La table en entrée doit être hébergée ou avoir été publiée sur un portail ArcGIS Enterprise. Les tables hébergées sont considérées comme faisant partie des couches d'entités hébergées et, pour pouvoir être utilisées dans l’outil, elles doivent être créées au préalable en tant qu’élément dans le portail. Pour plus d’informations, reportez-vous à la rubrique Publier des couches d’entités hébergées.
La couche d’entités hébergée en sortie est enregistrée dans la même référence spatiale que le localisateur d’adresses. Vous pouvez modifier la référence spatiale de la classe d’entités en sortie en définissant un système de coordonnées en sortie différent dans les paramètres d’environnement de l’outil.
La couche d’entités hébergée en sortie contiendra 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 adresses peuvent être ré-appariées à l’aide de l’outil Rematch Addresses (Ré-apparier les adresses) ou l’option Rematch Addresses (Ré-apparier les adresses) qui ouvre la fenêtre Rematch Addresses (Ré-apparier les adresses). Les résultats de géocodage produits par cet outil comprennent un instantané 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 service d’entités en sortie. Relancez l’outil pour créer un service d’entités en sortie qui contiendra ces modifications.

En savoir plus sur le réappariement des résultats de géocodage
Si 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.
Les paramètres suivants ne sont pas pris en charge pour tous les localisateurs utilisés pour la valeur du paramètre Address Locator (Localisateur d’adresses) : Country or Region (Pays ou région), Preferred Location Type (Type de localisation privilégié) et Category (Catégorie).
L’outil n’applique pas les configurations à partir d’une vue de localisateur créée dans ArcGIS Pro 3.2 s’il l’utilise comme valeur du paramètre Address Locator (Localisateur d’adresses).

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table du portail contenant les adresses ou les lieux à géocoder.	Record Set
Localisateur d’adresses	Localisateur du portail utilisé pour géocoder la table en entrée du portail. 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. Si le localisateur de portail que vous souhaitez utiliser ne figure pas dans la liste pré-renseignée, 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. Remarque : ArcGIS World Geocoding Service est désactivé pour cet outil. Pour utiliser le service ArcGIS World Geocoding Service, servez-vous de l’outil Geocode Addresses (Géocoder des adresses).	Address Locator
Appariement des 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. Précisez Single Field (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 Multiple Fields (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 Single Field and Country Field (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 (`Address`, `Address2` et `Address3`, par exemple). Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et 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 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
Nom de la couche d'entités en sortie	Nom de la couche d'entités géocodée en sortie qui sera créée sur le portail.	String
Pays ou région (Facultatif)	Pays auxquels se limite la recherche des adresses géocodées. Dans la plupart des cas, la spécification d’un pays contribue à accroître la précision du géocodage. Si aucun pays n’est spécifié, le géocodage est effectué en utilisant tous les pays pris en charge sur le localisateur. Si vous spécifiez Single Field and Country Field (Champ unique et champ de pays) dans le paramètre Adress Field Mapping (Appariement de champs d’adresse), la valeur de ce paramètre est remplacée.	String
Type d’emplacement préféré (Facultatif)	Spécifie la géométrie en sortie privilégiée qui est renvoyée pour les correspondances `PointAddress`. Si l’emplacement préféré n’existe pas dans les données, l’emplacement par défaut de Address location (Localisation d’adresse) est renvoyé. Consultez l’aide Web d’ArcGIS REST API pour en savoir plus sur le paramètre `locationType` dans le cadre de l’opération `geocodeAddresses`. Emplacement d’adresse—La 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. Il s’agit de l’option par défaut. Emplacement d’itinéraire—La 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é.	String
Catégorie (Facultatif)	Restreint les types de lieux que le localisateur recherche. Cela permet d’éliminer les faux positifs ainsi que les correspondances d’adresses non souhaitées, et de distinguer les recherches de coordonnées. Ce paramètre peut accélérer le processus de recherche. Si aucune catégorie n’est utilisée, le géocodage est effectué à l’aide de 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. Pour en savoir plus sur le filtrage des catégories, reportez-vous à l’aide Web d’ArcGIS REST API.	String
Champs en sortie (Facultatif)	Spécifie les champs de localisateur en sortie qui sont renvoyés dans les résultats de géocodage. Les noms de champ d’origine indiqués dans le paramètre Input Table (Table en entrée) sont conservés si l’option Location Only (Localisation uniquement), Minimal ou Minimal and User Fields (Champs minimaux et d’utilisateur) est spécifiée. Remarque : Ce paramètre peut être utilisé avec des localisateurs en entrée créés à l’aide de l’outil Create Locator (Créer un localisateur) ou Create Feature Locator (Créer un localisateur d’entités) publié dans Enterprise 10.9 ou une version ultérieure. Les localisateurs composites qui contiennent au moins un localisateur créé à l’aide de l’outil Create Address Locator (Créer un localisateur d’adresses) ne prennent pas en charge ce paramètre. Tous—Inclut 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 uniquement—Stocke le champ `Shape` dans les résultats de géocodage. Minimale—Ajoute 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`. Champs minimaux et d’utilisateur—Les champs `MINIMAL`, ainsi que les éventuels champs en sortie personnalisés définis par l’utilisateur, sont ajoutés et renvoyés dans les résultats du géocodage.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Couche en sortie	Hyperlien vers la couche d'entités des résultats géocodés en sortie dans le portail. Le nom de la couche d’entités découle de la valeur Output Feature Layer Name (Nom de la couche d’entités en sortie).	Feature Set

arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})

Nom	Explication	Type de données
in_table	Table du portail contenant les adresses ou les lieux à géocoder.	Record Set
in_address_locator	Localisateur du portail utilisé pour géocoder la table en entrée du portail. 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. Si le localisateur de portail que vous souhaitez utiliser ne figure pas dans la liste pré-renseignée, 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. Remarque : ArcGIS World Geocoding Service est désactivé pour cet outil. Pour utiliser le service ArcGIS World Geocoding Service, servez-vous de l’outil Geocode Addresses (Géocoder des adresses).	Address Locator
address_fields [[input_locator_field, table_field_name],...]	Chaque appariement de champs dans ce paramètre est au format `input_locator_field, table_field_name`, où `input_locator_field` est 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 contient 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, USA). Certains localisateurs prennent en charge plusieurs champs d’adresse en entrée (par exemple, `Address`, `Address2` et `Address3`). Dans ce cas, le composant d’adresse peut être divisé en plusieurs champs et 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 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 du nom d’un champ.	Field Info
output_name	Nom de la couche d'entités géocodée en sortie qui sera créée sur le portail.	String
country [country,...] (Facultatif)	Pays auxquels se limite la recherche des adresses géocodées. Dans la plupart des cas, la spécification d’un pays contribue à accroître la précision du géocodage. Si aucun pays n’est spécifié, le géocodage est effectué en utilisant tous les pays pris en charge sur le localisateur. Lorsqu’un champ de la valeur du paramètre `in_table` est apparié au champ `Country` dans le paramètre `address_fields`, la valeur de ce paramètre est remplacée. Spécifiez la valeur en tant que code pays à deux ou trois caractères dans une liste de valeurs séparées par des virgules. Reportez-vous à la rubrique Colonne des codes de pays pris en charge pour connaître la valeur en entrée à utiliser.	String
location_type (Facultatif)	Spécifie la géométrie en sortie privilégiée qui est renvoyée pour les correspondances `PointAddress`. Si la localisation privilégiée n’existe pas dans les données, la localisation par défaut de `ADDRESS_LOCATION` est renvoyée. Consultez l’aide Web d’ArcGIS REST API pour en savoir plus sur le paramètre `locationType` dans le cadre de l’opération `geocodeAddresses`. `ADDRESS_LOCATION`—La 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. Il s’agit de l’option par défaut. `ROUTING_LOCATION`—La 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é.	String
category [category,...] (Facultatif)	Restreint les types de lieux que le localisateur recherche. Cela permet d’éliminer les faux positifs ainsi que les correspondances d’adresses non souhaitées, et de distinguer les recherches de coordonnées. Ce paramètre peut accélérer le processus de recherche. Si aucune catégorie n’est utilisée, le géocodage est effectué à l’aide de 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. Pour en savoir plus sur le filtrage des catégories, reportez-vous à l’aide Web d’ArcGIS REST API.	String
output_fields (Facultatif)	Spécifie les champs de localisateur en sortie qui sont renvoyés dans les résultats de géocodage. Les noms de champ d’origine indiqués dans le paramètre `in_table` sont conservés si l’option `LOCATION_ONLY`, `MINIMAL` ou `MINIMAL_AND_USER` est spécifiée. Remarque : Ce paramètre peut être utilisé avec des localisateurs en entrée créés à l’aide de l’outil Create Locator (Créer un localisateur) ou Create Feature Locator (Créer un localisateur d’entités) publié dans Enterprise 10.9 ou une version ultérieure. Les localisateurs composites qui contiennent au moins un localisateur créé à l’aide de l’outil Create Address Locator (Créer un localisateur d’adresses) ne prennent pas en charge ce paramètre. `ALL`—Inclut 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_ONLY`—Stocke le champ `Shape` dans les résultats de géocodage. `MINIMAL`—Ajoute 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`. `MINIMAL_AND_USER`—Les champs `MINIMAL`, ainsi que les éventuels champs en sortie personnalisés définis par l’utilisateur, sont ajoutés et renvoyés dans les résultats du géocodage.	String

Sortie dérivée

Nom	Explication	Type de données
output_layer	Hyperlien vers la couche d'entités des résultats géocodés en sortie dans le portail. Le nom de la couche d’entités découle de la valeur Output Feature Layer Name (Nom de la couche d’entités en sortie).	Feature Set

Exemple de code

Exemple d’utilisation de la fonction GeocodeLocationsFromTable (script autonome)

Le script autonome suivant montre comment utiliser la fonction GeocodeLocationsFromTable pour géocoder une couche de tables hébergée.

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 Pro. 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 hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"

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

# The easiest way to generate a field mapping is to run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping =  "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"

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

# The output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator,
                                          field_mapping, output_name, country,
                                          location_type, category)

Environnements

Système de coordonnées en sortie

Informations de licence

Basic: Votre compte dans ArcGIS Enterprise doit bénéficier du privilège Perform Analysis (Effectuer des analyses)
Standard: Votre compte dans ArcGIS Enterprise doit bénéficier du privilège Perform Analysis (Effectuer des analyses)
Advanced: Votre compte dans ArcGIS Enterprise doit bénéficier du privilège Perform Analysis (Effectuer des analyses)

Géocoder des emplacements à partir d’une table (Outils de géocodage)

Résumé

Remarque :

Utilisation

Paramètres

Remarque :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes