Géocoder des adresses (Géocodage)

Synthèse

Assure le géocodage d’une table d’adresses. Ce processus nécessite une table qui stocke les adresses à géocoder et un localisateur d’adresses ou un localisateur d’adresses composite. Cet outil apparie les adresses stockées par rapport au localisateur et enregistre le résultat pour chaque enregistrement en entrée dans une nouvelle classe d’entités ponctuelles. Lors de l’utilisation de ArcGIS World Geocoding Service, cette opération peut consommer des crédits.

Pour réaliser des opérations de géocodage à l’aide de ArcGIS World Geocoding Service, vous avez besoin d’un compte d’organisation ArcGIS et de crédits. Le compte d’organisation doit disposer de suffisamment de crédits pour satisfaire à la totalité de la demande de géocodage.

Remarque :

L’estimation des crédits est disponible en haut de l’outil lorsque le portail actif est ArcGIS Online et que le localisateur en entrée est ArcGIS World Geocoding Service.

Utilisation

• 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.

• La classe d’entités en sortie est enregistrée dans la même référence spatiale que le localisateur d’adresses. Pour modifier la référence spatiale de la classe d’entités en sortie, définissez un système de coordonnées en sortie différent dans les paramètres d’environnement de l’outil.

• La classe d’entités en sortie, par défaut, stocke une copie de l’adresse en entrée et des informations complémentaires telles que le score, le statut et l’adresse appariée de chaque enregistrement. Les adresses peuvent être ré-appariées à l’aide de l’outil Ré-apparier les adresses ou l’option Ré-apparier les adresses qui ouvre la fenêtre Ré-apparier les adresses. La modification des adresses dans la table d’adresses en entrée ne change pas le résultat dans la classe d’entités en sortie une fois le processus d’appariement terminé et la classe d’entités créée.

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

• Un abonnement à ArcGIS Online for organizations est nécessaire pour apparier une table d’adresses à l’aide de ArcGIS World Geocoding Service.

• Les paramètres suivants ne sont pas pris en charge pour tous les localisateurs utilisés pour la valeur du paramètre Localisateur d’adresses en entrée : Pays ou région, Type de localisation privilégié et Catégorie.

• Pour générer la syntaxe Python correcte, exécutez d’abord l’outil depuis la fenêtre Géotraitement avec les options de paramètre appropriées. Ouvrez ensuite le menu Exécuter et sélectionnez l’option Copier la commande Python.

• Lorsque vous géocodez une table d’adresses ou de lieux avec un localisateur de type z, utilisez cet outil dans une scène locale. Les résultats de géocodage de type z seront automatiquement ajoutés à la scène locale, où les propriétés d’élévation sont définies sur l’option À une hauteur absolue .

  Si la scène locale contient la surface d’élévation utilisée pour numériser les données de référence ponctuelles ayant servi à créer le localisateur, définissez les propriétés d’élévation des résultats de géocodage sur l’option À une hauteur absolue . Vous pouvez effectuer cette opération dans la boîte de dialogue Propriétés de la couche sur l’onglet Élévation. Si la surface d’élévation utilisée pour créer les données de référence ne se trouve pas dans la scène locale, définissez l’élévation des résultats de géocodage sur l’option Par rapport au sol .

  Pour en savoir plus sur la définition des caractéristiques de hauteur des couches

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	Table des adresses qui seront géocodées.	Table View
Localisateur d’adresses en entrée	Localisateur d’adresses qui sera utilisé pour géocoder la table d’adresses. Remarque : L’inclusion de l’extension .loc après le nom du localisateur mentionné à la fin du chemin d’accès au localisateur est facultative.	Address Locator
Champs des adresses en entrée	Appariement des champs d’adresses utilisés par le localisateur d’adresses 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 et le pays sont répartis sur des champs distincts, tels que Address (303 Peachtree St NE, Atlanta, GA 30308) et Country (USA). 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 en entrée facultatif utilisé par le localisateur d’adresses avec un champ de la table d’adresses en entrée, précisez qu’il n’y a pas d’appariement en utilisant <Aucun> au lieu d’un nom de champ.	Field Info
Classe d’entités en sortie	Classe d’entités géocodées en sortie. Remarque : L’enregistrement de la sortie au format shapefile n’est pas pris en charge en raison de limitations liées aux shapefiles.	Feature Class
Classe d’entités dynamique en sortie (Facultatif)	Ce paramètre est désactivé ArcGIS Pro. Il n’est présent que pour assurer la rétrocompatibilité avec ArcGIS Desktop.	Boolean
Pays ou région (Facultatif)	Pays auxquels se limite la recherche des adresses géocodées. L’indication d’un pays contribue à accroître la précision du géocodage. Dans le cas où aucun pays n’est indiqué, le géocodage est effectué pour tous les pays pris en charge par le localisateur. Cette valeur de paramètre est remplacée lorsque vous spécifiez Champ unique et champ Pays pour le paramètre Champs d’adresse en entrée.	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. Si la localisation préférée n’existe pas dans les données, la localisation par défaut de Localisation d’adresse est renvoyée. Voir l’aide Web de ArcGIS REST API pour en savoir plus sur le paramètre locationType pour geocodeAddresses. Localisation 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. Localisation 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 et 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é 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. Consultez l’aide Web de ArcGIS REST API pour en savoir plus sur le filtrage des catégories.	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 Table en entrée sont conservés si l’option Localisation uniquement, Minimal ou Champs minimaux et d’utilisateur est sélectionnée. Tout—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. Localisation uniquement—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. 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. 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 stocké sur le disque ou 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

Python

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields})

Nom	Explication	Type de données
in_table	Table des adresses qui seront géocodées.	Table View
address_locator	Localisateur d’adresses qui sera utilisé pour géocoder la table d’adresses. Remarque : L’inclusion de l’extension .loc après le nom du localisateur mentionné à la fin du chemin d’accès au localisateur est facultative.	Address Locator
in_address_fields [input_address_field, table_field_name]	Chaque appariement de champ dans ce paramètre est au format input_address_field, table_field_name, où input_address_field est le nom du champ d’adresse en entrée défini par le localisateur d’adresses et où table_field_name est 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 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 en entrée facultatif utilisé par le localisateur d’adresses avec un champ de 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
out_feature_class	Classe d’entités géocodées en sortie. Remarque : L’enregistrement de la sortie au format shapefile n’est pas pris en charge en raison de limitations liées aux shapefiles.	Feature Class
out_relationship_type (Facultatif)	Héritage : Ce paramètre n’a aucun effet dans ArcGIS Pro. Il n’est présent que pour assurer la rétrocompatibilité avec ArcGIS Desktop. Dans ArcGIS Pro, la seule version acceptable est STATIC. STATIC—Une copie statique de la table d’adresses en entrée des champs est créée dans la classe d’entités en sortie. Il s’agit de la seule valeur acceptable. DYNAMIC—Cette option ne s’applique pas dans ArcGIS Pro. Consultez l’aide de ArcGIS Desktop relative à cet outil.	Boolean
country [country,...] (Facultatif)	Pays auxquels se limite la recherche des adresses géocodées. L’indication d’un pays contribue à accroître la précision du géocodage. Dans le cas où aucun pays n’est indiqué, le géocodage est effectué pour tous les pays pris en charge par le localisateur. Lorsqu’un champ de la valeur du paramètre in_table est apparié au champ Country dans le paramètre in_address_fields, la valeur de ce paramètre est remplacée. Indiquez la valeur sous la forme d’une liste de codes de pays à 2 ou 3 caractères séparés par des virgules. Voir la colonne Codes des langues prises en charge pour connaître la valeur à utiliser.	String
location_type (Facultatif)	Spécifie la géométrie en sortie de votre choix allant être renvoyée pour les correspondances PointAddress. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut ADDRESS_LOCATION est renvoyé. Voir l’aide Web de ArcGIS REST API pour en savoir plus sur le paramètre locationType pour 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 et 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é 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. 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. 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 Créer un localisateur ou Créer un localisateur d’entités stocké sur le disque ou 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. 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

Exemple de code

Exemple 1 d’utilisation de l’outil GeocodeAddresses (script autonome)

Le script suivant montre comment utiliser la fonction GeocodeAddresses pour géocoder une table d’adresses avec un localisateur local.

import arcpy

arcpy.env.workspace = "C:\Geocoding\atlanta"

# Set local variables
table = "customers.dbf"
locator = "Atlanta_AddressLocator.loc"
field_map = ("\'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 <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, 
                                 field_map, geocode_result)

Exemple 2 d’utilisation de l’outil GeocodeAddresses (script autonome)

Le script suivant montre comment utiliser la fonction GeocodeAddresses pour géocoder une table d’adresses avec un localisateur de type serveur via une connexion AGS.

import arcpy

# Set local variables:
table = r"C:\data\Atlanta.gdb\customers"
locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
field_map = "'Single Line Input' SingleLine VISIBLE NONE"
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator,
                                 field_map, geocode_result)

Exemple 3 d’utilisation de l’outil GeocodeAddresses (script autonome)

Le script suivant montre comment utiliser la fonction GeocodeAddresses pour géocoder une table d’adresses avec un localisateur de type portail.

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 votre portail actif, vous devez vous authentifier à l’aide de la fonction SignInToPortal.

import arcpy

# Set local variables
table = r"C:\data\Atlanta.gdb\customers"
locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
field_map = ("\'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 <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Exemple 4 d’utilisation de l’outil GeocodeAddresses (script autonome)

Le script suivant montre comment utiliser la fonction GeocodeAddresses pour géocoder une table d’adresses avec le ArcGIS World Geocoding Service.

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 votre portail actif, vous devez vous authentifier à l’aide de la fonction SignInToPortal.

Remarque :

Lors de l’utilisation de ArcGIS World Geocoding Service, cette opération peut consommer des crédits.

import arcpy

# Set local variables
table = r"C:\data\Addresses.csv"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
             "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;Subregion <None> VISIBLE NONE;" +
             "Region <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
             "Country <None> VISIBLE NONE")

geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Exemple 5 d’utilisation de l’outil GeocodeAddresses (script autonome)

Le script suivant montre comment utiliser la fonction GeocodeAddresses pour géocoder une table d’adresses, dans laquelle toutes les données d’adresse se trouvent dans un seul champ et les données de pays se trouvent dans un second champ, avec le ArcGIS World Geocoding Service.

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 votre portail actif, vous devez vous authentifier à l’aide de la fonction SignInToPortal.

Remarque :

Lors de l’utilisation de ArcGIS World Geocoding Service, cette opération peut consommer des crédits.

import arcpy

# Set local variables
table = r"C:\Data\MyDatabase.gdb\DistributionCenters"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = "'Single Line Input' SingleLine VISIBLE NONE;Country Country VISIBLE NONE"

geocode_result = r"C:\Data\MyDatabase.gdb\DistributionCenters_Geocoded"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Environnements

Mot-clé CONFIG en sortie, Système de coordonnées en sortie

Informations de licence

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