Résumé
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 par rapport au localisateur d’adresses et enregistre le résultat pour chaque enregistrement en entrée dans une nouvelle classe d’entités points. Si vous utilisez ArcGIS World Geocoding Service, cette opération peut consommer des crédits.
Illustration
Utilisation
Vous pouvez géocoder des adresses qui sont stockées dans un seul champ ou qui sont divisées en plusieurs champs. Un seul champ 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, 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.
La classe d'entités en sortie est enregistrée dans la même référence spatiale que le localisateur d'adresses. Il est possible de 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 classe d'entités en sortie, par défaut, stocke une copie de l'adresse en entrée et des informations complémentaires comme le score, le statut et l'adresse appariée de chaque enregistrement. Les adresses peuvent être ré-appariées à l'aide de l'outil Rematch Addresses (Réapparier les adresses) ou de la boîte de dialogue Interactive Rematch (Réappariement interactif) dans ArcMap. 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.
Attribuez au paramètre Classe d'entités dynamique en sortie la valeur vrai (activé) pour que le résultat apparié soit mis à jour automatiquement dans la classe d'entités en sortie lors de la mise à jour de la table d'adresses en entrée. Une classe de relations est créée pour la table en entrée et la classe d'entités en sortie. Lorsqu'une adresse dans la table en entrée est modifiée au cours d'une session de mise à jour dans ArcMap, l'adresse est géocodée à nouveau immédiatement et l'enregistrement associé dans la classe d'entités en sortie est mis à jour avec le nouveau résultat de géocodage. La mise à jour automatique est aussi prise en charge pour l'ajout d'un nouvel enregistrement ou la suppression d'un enregistrement existant dans la table en entrée.
Un abonnement ArcGIS Online for organizations est nécessaire pour apparier une table d'adresses à l'aide de ArcGIS World Geocoding Service. Pour plus d'informations, reportez-vous à la rubrique Utilisation du service de géocodage mondial ArcGIS Online.
Syntaxe
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})| Paramètre | 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. | 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 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 contient l’adresse complète, par exemple 303 Peachtree St NE, Atlanta, GA 30308. Vous pouvez aussi spécifier plusieurs champs si les adresses en entrée sont réparties sur différents 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 <Aucun> au lieu d'un nom de champ (voir l'exemple ci-dessous). | Field Info |
out_feature_class | Classe d'entités ou fichier de formes géocodé(e) en sortie. | Feature Class |
out_relationship_type (Facultatif) | Indique s'il convient de créer une copie statique de la table d'adresses au sein de la classe d'entités géocodée ou de créer une classe d'entités géocodée mise à jour dynamiquement.
| Boolean |
country [country,...] (Facultatif) | Le géocodage se limite aux pays sélectionnés. Si aucun pays n’est utilisé, le géocodage s’effectue sur tous les pays pris en charge. Sélectionner des pays améliore la précision du géocodage dans la plupart des cas. Si un champ représentant des pays dans Input Table (Table en entrée) est apparié au Input Address Field (Champ d’adresse en entrée) CountryCode, la valeur du pays dans Input Table (Table en entrée) remplace le paramètre Country (Pays). La valeur en entrée doit être spécifiée sous forme d’un code de pays ISO 3166-1 de 3 caractères. Ce paramètre n’est pas pris en charge pour tous les localisateurs. | String |
location_type (Facultatif) | Indique la géométrie en sortie préférée pour les appariements PointAddress. Les options sont l’emplacement du côté de la rue, qui peut servir au calcul d’itinéraire, ou le centroïde de toit ou de parcelle pour 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. Consultez l’aide web de l’API REST 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 |
Exemple de code
Exemple d’utilisation de l’outil GeocodeAddresses (fenêtre Python)
Le script de fenêtre Python suivant illustre l’utilisation de la fonction GeocodeAddress en mode immédiat à l’aide du géocodage sur plusieurs lignes.
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
Exemple d’utilisation de l’outil GeocodeAddresses (fenêtre Python)
Le script de fenêtre Python suivant illustre l’utilisation de la fonction GeocodeAddress en mode immédiat à l’aide du géocodage sur une seule ligne.
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "'Single Line Input' SINGLELINE"
geocode_result = "singleline_geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
Environnements
Informations de licence
- Basic: Limité
- Standard: Oui
- Advanced: Oui