| Étiquette | Explication | Type de données |
Table en entrée | Table d'adresses à géocoder. | Table View |
Localisateur d’adresses en entrée | Localisateur d'adresses à utiliser 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. Sélectionnez 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. Sélectionnez Champs multiples 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. Sélectionnez Champ unique et Champ de pays si l’adresse complète et le pays sont répartis sur des champs distincts, tels queAddress (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 (Facultatif) | 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 pays contribue à accroître la précision du géocodage. Lorsque vous sélectionnez Champ unique et Champ de pays pour le paramètre Champs des adresses en entrée et que vous appariez un champ représentant les pays d’après la valeur du paramètre Table en entrée avec le champ Country comme valeur du paramètre Champs des adresses en entrée, la valeur du pays du paramètre Table en entrée remplace celle du paramètre Pays. Limite l’opération aux pays sélectionné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 d’emplacement préféré (Facultatif) | Spécifie la géométrie en sortie de votre choix 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 préféré n’existe pas dans les données, l’emplacement par défaut 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 centroïde de toit ou de bâtiment. Ce paramètre n’est pas pris en charge pour tous les localisateurs.
| 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. En règle générale, le paramètre peut être utilisé dans les buts suivants :
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 |
Champs en sortie (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 stockés sur le disque ou publiés dans Enterprise version 10.9 ou 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 |
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 fractionnées en plusieurs champs, ou 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 fractionnées en 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 qui indique l’adresse complète, comme 303 Peachtree St NE, Atlanta, GA 30308, et un champ qui indique le pays associé à l’adresse, comme les États-Unis, sont é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.
Paramètres
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 d'adresses à géocoder. | Table View |
address_locator | Localisateur d'adresses à utiliser 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 réparties sur plusieurs champs, tels que Address, City, State et ZIP dans le cas d’une adresse générale aux États-Unis. Vous pouvez aussi spécifier un seul champ en entrée qui indique l’adresse complète, comme 303 Peachtree St NE, Atlanta, GA 30308, et un champ qui indique le pays associé à l’adresse, comme les É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 <Aucun> 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.
| Boolean |
country [country,...] (Facultatif) | 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. L’indication d’un pays contribue à accroître la précision du géocodage. Si un champ représentant les pays du paramètre in_table est apparié avec le champ Country comme valeur du paramètre input_address_field, la valeur du pays du paramètre in_table remplace celle du paramètre country. 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. 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) | Indique la géométrie en sortie privilégiée pour les 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 privilégié n’existe pas dans les données, l’emplacement par défaut 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. 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.
| 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. En règle générale, le paramètre peut être utilisé dans les buts suivants :
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 stockés sur le disque ou publiés dans Enterprise version 10.9 ou 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 |
Exemple de code
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 = "geocode_result.shp"
arcpy.geocoding.GeocodeAddresses(table, locator,
field_map, geocode_result)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:\outputs\geocode_result.shp"
arcpy.geocoding.GeocodeAddresses(table, locator,
field_map, geocode_result)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:\outputs\geocode_result.shp"
arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)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"
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:\outputs\geocode_result.shp"
arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)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"
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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui