Créer un fichier d’emplacements à partir d’un fichier texte (Renseignement)

Synthèse

Crée un fichier d’emplacements à utiliser dans ArcGIS LocateXT à partir d’un fichier texte issu du service GeoNames (Geonet Names Server) de l’Agence nationale de renseignement géospatial ou du Système d’information toponymique de l’Institut d’études géologiques des États-Unis.

Utilisation

  • Cet outil prend un fichier texte en entrée issu de GeoNames, du serveur de noms Geonet (GNS) de la National Geospatial-Intelligence Agency (NGA) ou de l’U. S. Geological Survey (USGS) Geographic Names Information Service (GNIS) pour les États-Unis et l’Antarctique, et crée un fichier d’emplacements personnalisé utilisable par les outils Extraire les emplacements du texte et Extraire les emplacements du document ou dans la fenêtre Extraire les emplacements. Pour plus d’informations sur l’activation des emplacements personnalisés pour ces outils, reportez-vous à la rubrique Ajouter et gérer des emplacements et des fichiers d’attributs personnalisés.

    L’outil crée un fichier d’emplacements (.lxtgaz) pouvant être utilisé dans l’onglet Emplacements personnalisés de la fenêtre Extraire les emplacements et avec les outils Extraire les emplacements du document et Extraire les emplacements du texte.

  • Le paramètre Source de données est utilisé pour identifier la source du fichier en entrée. Les formats GeoNames, GNS et GNIS contiennent des schémas et des séparateurs uniques. Si la source de données spécifiée est incorrecte, le fichier en sortie sera vide. Dans ce cas, assurez-vous que la source de données sélectionnée correspond au fichier de noms de lieu en entrée.

  • Le paramètre Inclure les entités est utilisé pour limiter les types de classe d’entités compris dans la sortie. Le filtrage peut s’effectuer en fonction des types de classe d’entités suivants :

    • Administration
    • Zones peuplées
    • Végétation
    • Localité
    • Milieu sous-marin
    • Transport
    • MNT
    • Hydrologique
    • Spot

    Vous pouvez également filtrer en spécifiant une région d’intérêt. Lorsqu’une région d’intérêt est spécifiée, la valeur résultante du paramètre Fichier d’emplacements en sortie ne contient que des résultats entièrement compris dans la région d’intérêt spécifiée.

  • Les fichiers de noms de lieu peuvent être téléchargés à partir des emplacements suivants :

Paramètres

ÉtiquetteExplicationType de données
Fichier de noms de lieu en entrée

Fichier texte de noms de lieu obtenu depuis le service GeoNames, NGA GNS ou USGS GNIS.

File
Source de données

Spécifie la source de données à partir de laquelle l’entrée a été créée.

  • GeoNamesLe fichier en entrée provient de GeoNames.org.
  • NGA GNSLe fichier en entrée provient du service NGA GNS.
  • USGS GNISLe fichier en entrée provient du service USGS GNIS.
  • USGS Antarctic NamesLe fichier en entrée provient du service USGS Antarctic Names.
String
Fichier d’emplacements en sortie

Le fichier d’emplacements en sortie.

File
Inclure les entités
(Facultatif)

Spécifie les types de classe d’entités de la source de données en entrée qui sera incluse dans la sortie.

  • Entités administrativesLes entités administratives (par exemple, limites administratives, ville, État, province, frontières tribales et frontières de pays) sont incluses.
  • Entités hydrologiquesLes entités telles que les rivières, les lacs, les ponts et autres entités d’eau sont incluses.
  • Entités de localitéLes entités telles que les bâtiments, les églises, les hôpitaux et autres points d’intérêt construits par l’homme sont incluses.
  • Zones peupléesLes emplacements de lieu nommé (par exemple, villes, villages et autres zones consolidées de personnes) sont inclus.
  • Entités de transportLes entités telles que les routes, les sentiers, les voies ferrées et les aéroports sont incluses.
  • Entités de spotLes entités hypsographiques telles que les sommets de montagne et autres points d’intérêt naturel sont incluses.
  • Entités de terrainLes entités telles que les montagnes, les collines, les cratères et les crêtes sont incluses.
  • Entités de végétationLes entités telles que les forêts, la brousse, la garrigue et autres zones de végétation dense seront incluses.
  • Entités de milieu sous-marinLes entités de milieu sous-marin telles que les récifs, les bancs de sable et les épaves seront incluses.
String
Régions d’intérêt en entrée
(Facultatif)

Couche d’entités utilisée pour créer un sous-ensemble du fichier de noms de lieu en entrée.

Feature Layer

arcpy.intelligence.CreateLocationFileFromTextFile(in_placenames_file, data_source, out_location_file, {include_features}, {in_rois})
NomExplicationType de données
in_placenames_file

Fichier texte de noms de lieu obtenu depuis le service GeoNames, NGA GNS ou USGS GNIS.

File
data_source

Spécifie la source de données à partir de laquelle l’entrée a été créée.

  • GEONAMESLe fichier en entrée provient de GeoNames.org.
  • NGA_GNSLe fichier en entrée provient du service NGA GNS.
  • USGS_GNISLe fichier en entrée provient du service USGS GNIS.
  • USGS_ANTARCTIC_NAMESLe fichier en entrée provient du service USGS Antarctic Names.
String
out_location_file

Le fichier d’emplacements en sortie.

File
include_features
[include_features,...]
(Facultatif)

Spécifie les types de classe d’entités de la source de données en entrée qui sera incluse dans la sortie.

  • ADMINISTRATIVE_FEATURESLes entités administratives (par exemple, limites administratives, ville, État, province, frontières tribales et frontières de pays) sont incluses.
  • HYDROLOGICAL_FEATURESLes entités telles que les rivières, les lacs, les ponts et autres entités d’eau sont incluses.
  • LOCALITY_FEATURESLes entités telles que les bâtiments, les églises, les hôpitaux et autres points d’intérêt construits par l’homme sont incluses.
  • POPULATED_PLACESLes emplacements de lieu nommé (par exemple, villes, villages et autres zones consolidées de personnes) sont inclus.
  • TRANSPORTATION_FEATURESLes entités telles que les routes, les sentiers, les voies ferrées et les aéroports sont incluses.
  • SPOT_FEATURESLes entités hypsographiques telles que les sommets de montagne et autres points d’intérêt naturel sont incluses.
  • TERRAIN_FEATURESLes entités telles que les montagnes, les collines, les cratères et les crêtes sont incluses.
  • VEGETATION_FEATURESLes entités telles que les forêts, la brousse, la garrigue et autres zones de végétation dense seront incluses.
  • UNDERSEA_FEATURESLes entités de milieu sous-marin telles que les récifs, les bancs de sable et les épaves seront incluses.
String
in_rois
(Facultatif)

Couche d’entités utilisée pour créer un sous-ensemble du fichier de noms de lieu en entrée.

Feature Layer

Exemple de code

CreateLocationFileFromTextFile (script autonome)

Le code suivant illustre l’utilisation de la fonction CreateLocationFileFromTextFile dans un script autonome.

# Name: CreateLocationFileFromTextFile.py
# Description: Create a custom location file for use with LocateXT. 

# Import system modules 
import arcpy 

source_file = r'C:\data\US.txt'
data_source = 'GEONAMES'
location_file = r'C:\data\US.lxtgaz'
filter_features = ['POPULATED_PLACES']
loudoun_county = r'C:\virginia.gdb\loudoun_co'

arcpy.intelligence.CreateLocationFileFromTextFile(source_file,
                                                  data_source,
                                                  location_file,
                                                  filter_features,
                                                  loudoun_county)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.