从文本文件创建位置文件 (情报)

摘要

从 GeoNames、国家地理空间情报局 Geonet 名称服务器或美国地质勘探局地理名称信息服务的文本文件创建位置文件，以用于 ArcGIS LocateXT。

使用情况

• 该工具从 GeoNames、国家地理空间情报局 (NGA) Geonet 名称服务器 (GNS) 或美国地质勘探局 (USGS) 地理名称信息服务 (GNIS) 获取美国和南极洲的输入文本文件，然后创建可用于从文本中提取位置和从文档中提取位置工具或提取位置窗格的自定义位置文件。 有关如何为这些工具启用自定义位置的信息，请参阅添加和管理自定义位置和自定义属性文件。

  此工具将创建自定义位置文件 (.lxtgaz)，可用于提取位置窗格的自定义位置选项卡，以及从文档提取位置和从文本提取位置工具。

• 数据源参数用于识别输入文件的源。 GeoNames、GNS 和 GNIS 格式包含唯一方案和分隔符。 如果指定的数据源不正确，则输出文件将为空。 如果发生此情况，请确保所选数据源与输入地名文件相匹配。

• 包括要素参数用于限制输出中包括的要素类类型。 可以根据以下要素类类型进行过滤：

  • 行政
  • 居民区
  • 植被
  • 地点
  • 海底
  • 交通运输
  • 地势图
  • 水文
  • 点

  您也可以通过指定感兴趣区域来进行过滤。 如果您指定感兴趣区域，所生成的输出位置文件参数值将仅包括完全包含于指定感兴趣区域的结果。

• 可以从以下位置下载地名文件：

  • GeoNames
  • NGA Geonet 名称服务器
  • USGS 地理名称信息服务
  • USGS 南极名称

参数

对话框

标注	说明	数据类型
输入地名文件	从 GeoNames、NGA GNS 或 USGS GNIS 获得的地名文本文件。	File
数据源	指定用于创建输入的数据源。 GeoNames—输入文件来自 GeoNames.org。 NGA GNS—输入文件来自 NGA GNS。 USGS GNIS—输入文件来自 USGS GNIS。 USGS 南极名称—输入文件来自 USGS GNIS 南极名称。	String
输出位置文件	输出位置文件。	File
包括要素 (可选)	指定来自输入数据源的要素类类型，这些类型将包含在输出中。 行政要素—将包括如行政边界、城镇、州、部落、国家边界等行政要素。 水文要素—将包括如河流、湖泊、池塘和其他水体等要素。 地点要素—将包括如建筑物、教堂、医院和其他人造感兴趣点等要素。 居民区—将包括如城镇、城市、村庄和其他人员聚集区域等已命名地点的位置。 交通运输要素—将包括如道路、路径、铁路和机场等要素。 点要素—将包括如山峰和其他自然感兴趣点等测高要素。 地形要素—将包括如山脉、丘陵、悬崖、火山口和山脊等要素。 植被要素—将包括如森林、原始林区、灌木丛林地和其他统一植被区域等要素。 海底要素—将包括如礁石、障碍、沉船等要素。	String
感兴趣区域输入 (可选)	将用于创建输入地名文件子集的要素图层。	Feature Layer

Python

arcpy.intelligence.CreateLocationFileFromTextFile(in_placenames_file, data_source, out_location_file, {include_features}, {in_rois})

名称	说明	数据类型
in_placenames_file	从 GeoNames、NGA GNS 或 USGS GNIS 获得的地名文本文件。	File
data_source	指定用于创建输入的数据源。 GEONAMES—输入文件来自 GeoNames.org。 NGA_GNS—输入文件来自 NGA GNS。 USGS_GNIS—输入文件来自 USGS GNIS。 USGS_ANTARCTIC_NAMES—输入文件来自 USGS GNIS 南极名称。	String
out_location_file	输出位置文件。	File
include_features [include_features,...] (可选)	指定来自输入数据源的要素类类型，这些类型将包含在输出中。 ADMINISTRATIVE_FEATURES—将包括如行政边界、城镇、州、部落、国家边界等行政要素。 HYDROLOGICAL_FEATURES—将包括如河流、湖泊、池塘和其他水体等要素。 LOCALITY_FEATURES—将包括如建筑物、教堂、医院和其他人造感兴趣点等要素。 POPULATED_PLACES—将包括如城镇、城市、村庄和其他人员聚集区域等已命名地点的位置。 TRANSPORTATION_FEATURES—将包括如道路、路径、铁路和机场等要素。 SPOT_FEATURES—将包括如山峰和其他自然感兴趣点等测高要素。 TERRAIN_FEATURES—将包括如山脉、丘陵、悬崖、火山口和山脊等要素。 VEGETATION_FEATURES—将包括如森林、原始林区、灌木丛林地和其他统一植被区域等要素。 UNDERSEA_FEATURES—将包括如礁石、障碍、沉船等要素。	String
in_rois (可选)	将用于创建输入地名文件子集的要素图层。	Feature Layer

代码示例

CreateLocationFileFromTextFile（独立脚本）

以下代码演示了如何在独立脚本中使用 CreateLocationFileFromTextFile 函数。

# 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)

环境

此工具不使用任何地理处理环境。