点距离 (分析)

摘要

在某一指定搜索半径范围内，确定输入点要素与邻近要素中所有点之间的距离。

插图

用法

• 计算所有输入要素与所有邻近要素之间的距离时，如果使用默认搜索半径，则此工具将创建两组点之间的距离矩阵。输出表可能非常大。例如，如果输入要素和邻近要素各包含 1000 个点，则输出表会包含一百万条记录。使用有意义的搜索半径来限制输出的大小。

• 结果将记录在输出表中，其中包含以下信息：

  • INPUT_FID：输入要素的要素 ID。
  • NEAR_FID：邻近要素的要素 ID。
  • DISTANCE：输入要素与邻近要素之间的距离。

• 输入要素和邻近要素可以是相同的数据集。在输入要素和邻近要素是相同记录的情况下，将忽略这一结果，这样就不会报告与一个要素的距离是 0 个单位的要素本身。

语法

PointDistance_analysis (in_features, near_features, out_table, {search_radius})

参数	说明	数据类型
in_features	计算点要素与邻近要素之间的距离时作为起点的点要素。	Feature Layer
near_features	计算输入要素与点之间的距离时作为终点的点。可通过为输入要素和邻近要素指定同一要素类或图层来确定同一要素类或图层范围内各点之间的距离。	Feature Layer
out_table	包含输入要素列表和搜索半径内所有邻近要素相关信息的表。如果未指定搜索半径，则计算所有输入要素与所有邻近要素之间的距离。	Table
search_radius （可选）	仅计算位于输入要素搜索半径范围内的邻近要素与输入要素之间的距离。	Linear unit

代码示例

PointDistance 示例 1（Python 窗口）

以下 Python 交互式窗口脚本演示了如何在立即模式下使用 PointDistance 函数。

import arcpy arcpy.env.workspace = "C:/data/pointdistance.gdb"    arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")

PointDistance 示例 2（独立 Python 脚本）

以下 Python 脚本演示了如何在独立脚本中使用 PointDistance 函数。

# Name: PointDistance.py # Description: Finds distance of each near point from each input point and outputs to a table. # Author: ESRI    # import system modules import arcpy from arcpy import env    # set workspace environment env.workspace = "C:/data/pointdistance.gdb"    # set variables inFeatures = "police_stations" nearFeatures = "crime_location" outTable = "crime_distance4" searchRadius = "22000 Feet"    # find crime locations within the search radius arcpy.PointDistance_analysis(inFeatures, nearFeatures, outTable, searchRadius)

环境

范围, 当前工作空间, 临时工作空间

许可信息

ArcView: 否

ArcEditor: 否

ArcInfo: 是