点距离 (Analysis)

许可等级:BasicStandardAdvanced

摘要

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

了解有关如何使用地理处理工具计算邻近值的详细信息。

插图

Point Distance illustration

用法

语法

PointDistance_analysis (in_features, near_features, out_table, {search_radius})
参数说明数据类型
in_features

计算点要素与邻近要素之间的距离时作为起点的点要素。

Feature Layer
near_features

计算输入要素与点之间的距离时作为终点的点。可通过为输入要素和邻近要素指定同一要素类或图层来确定同一要素类或图层范围内各点之间的距离。

Feature Layer
out_table

包含输入要素列表和搜索半径内所有邻近要素相关信息的表。如果未指定搜索半径,则计算所有输入要素与所有邻近要素之间的距离。

Table
search_radius
(可选)

指定用于搜索候选邻近要素的半径。将考虑此半径中的邻近要素来计算最近的要素。如果未指定值(即使用默认(空)半径),则在计算中考虑所有邻近要素。搜索半径的单位默认为输入要素的单位。可以将单位更改为任何其他单位。但是,这对输出 DISTANCE 字段的单位不会产生任何影响,后者基于输入要素的坐标系单位。

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 函数。

# Description: Finds distance of each near point from each input point and outputs to a table.
  
# import system modules
import arcpy
  
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
  
try:
    # find crime locations within the search radius
    arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
    print arcpy.GetMessages(0)
    
except arcpy.ExecuteError:
    print arcpy.GetMessages(2)
    
except Exception as ex:
    print ex.args[0]

环境

相关主题

许可信息

ArcGIS for Desktop Basic:否
ArcGIS for Desktop Standard:否
ArcGIS for Desktop Advanced:是
9/15/2013