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 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 qui sont stockées dans un seul champ ou dans plusieurs. 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.
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 ; 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 une version ultérieure est requis pour utiliser cet outil.
L’utilisation d’un localisateur sur le portail ArcGIS Enterprise configuré pour utiliser plusieurs threads améliore la performance de géocodage.
Pour que cet outil puisse s’exécuter, la table utilisée 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 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 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. Il est nécessaire d’exécuter à nouveau cet outil pour créer un service d’entités en sortie qui contiendra ces modifications.
Pour en savoir plus sur le ré-appariement des résultats de géocodage
Syntaxe
arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})| Paramètre | 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 sélectionner 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 :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 [input_locator_field, table_field_name] | 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 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 é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. 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 ; 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. Si vous choisissez de ne pas apparier 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 |
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 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 les pays dans le paramètre Input Table (Table en entrée) est apparié au champ d’adresse en entrée Country, la valeur du pays issue du 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é pour tous les pays pris en charge par le localisateur. Spécifiez la valeur en entré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, ce qui correspond au côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou ADDRESS_LOCATION, c’est-à-dire l’emplacement représentant le toit, le centroïde de parcelle de l’adresse ou la porte principale. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut ROUTING_LOCATION est renvoyé. 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. Consultez l’aide Web de l’API REST pour en savoir plus sur le paramètre locationType dans le cadre de l’opération 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é pour 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. Consultez l’aide web de l’API REST 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 les localisateurs en entrée créés à l’aide de l’outil Créer un localisateur ou Créer un localisateur d’entités publié 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 |
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). | Jeu d’entités |
Exemple de code
Le script autonome suivant montre comment utiliser la fonction GeocodeLocationsFromTable pour géocoder une couche de tables hébergée.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# 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 by running 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
# Note that 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
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 ?