邻近汇总 (标准要素分析)

描述

在输入图层中查找处于指定要素距离内的要素。

距离可按直线距离或指定的出行模式进行测量。然后,计算邻近要素的统计数据,如下所示:

  • 计算在建议的新商店位置 5 分钟车程内的总人口数。
  • 计算在建议的新商店位置的 1 英里行驶距离内的高速公路匝道数,以便测量商店的可达性。

插图

邻近汇总

使用方法

  • 邻近汇总工具需要两个输入图层:用于测量距离的图层和要汇总的图层。两个图层均可为点、线或面。第一个输入图层最多可包含 1000 个要素。

  • 邻近距离可基于直线距离或多种不同的出行模式,使用时间或距离作为测量单位。仅当您的第一个输入图层包含点要素时才启用出行模式。您可通过输入多个距离或时间来创建多个输出面。

  • 一些出行模式具有使用交通状况的选项。使用交通状况时,结果可能取决于当周指定日期和时间的实时状况或典型状况。实时交通状况可能与当前时间偏移多达 12 小时。全天均可将典型状况的时间间隔设置为 15 分钟。

  • 出行模式可由组织管理员进行配置。管理员还可以添加新的出行模式或移除并非组织必需的出行模式。默认距离测量单位将为英里或千米,具体取决于配置文件中的 units 设置。

语法

arcpy.sfa.SummarizeNearby(sumNearbyLayer, summaryLayer, outputName, nearType, {distances}, {units}, {timeOfDay}, {timeZoneForTimeOfDay}, {returnBoundaries}, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
参数说明数据类型
sumNearbyLayer

用作输入汇总图层中到要素的距离的测量起点的点、线或面要素。

Feature Set
summaryLayer

点、线或面要素。将汇总此图层中与输入邻近要素图层中的要素相距指定距离的要素。

Feature Set
outputName

要在门户中创建的输出图层的名称。

String
nearType

定义要使用的距离测量方式:按直线距离进行测量,或利用多种交通方式(称为出行模式)通过测量沿街道网络的行驶时间或行驶距离来进行测量。

  • STRAIGHTLINE使用直线欧式距离测量法。这是默认设置。
  • DRIVINGDISTANCE使用汽车行驶距离。
  • DRIVINGTIME使用在指定汽车行驶时间内行驶的距离。
  • TRUCKINGDISTANCE使用卡车行驶距离。
  • TRUCKINGTIME使用在指定卡车行驶时间内行驶的距离。
  • WALKINGDISTANCE使用沿街道步行的距离。
  • WALKINGTIME使用指定步行时间内行驶的距离。
String
distances
[distances,...]
(可选)

定义搜索距离(针对直线和基于距离的出行模式)或时间(针对基于时间的出行模式)的双精度值列表。可以输入一个距离值或多个距离值。汇总处于您所输入距离内(包含该距离)的要素。距离值的 unitsunits 参数提供。

Double
units
(可选)

如果邻近类型为基于直线或基于距离的出行模式,则此单位应为与距离中指定的距离值一同使用的线性单位。有效选项包括米、千米、英尺、码和英里。

如果邻近要素类型为基于时间的出行模式,则值将包括秒、分钟和小时。

  • MILES英里
  • FEET英尺
  • KILOMETERS千米
  • METERS
  • YARDS
  • SECONDS
  • MINUTES
  • HOURS小时
String
timeOfDay
(可选)

指定行驶时间是否应该考虑交通状况。要在分析中使用流量,必须将邻近要素类型设置为基于出行时间的模式。时间值表示出行开始或离开输入点的时间。

支持两种类型的流量:典型流量和实时流量。典型流量将参考行驶速度,该速度由一周内每 5 分钟执行一次测速所得的历史平均速度组成。实时流量从流量源(用于处理电话调查记录、传感器和其他数据源)检索速度以记录实际行驶速度并预测近期速度。

要确保任务在适用的位置使用典型流量,请选择该周的某个时间和某天,并将这天转换为 1990 年的以下某个日期:

  • 星期一 - 1/1/1990
  • 星期二 - 1/2/1990
  • 星期三 - 1/3/1990
  • 星期四 - 1/4/1990
  • 星期五 - 1/5/1990
  • 星期六 - 1/6/1990
  • 星期日 - 1/7/1990
尽管用来表示该周各天的日期来自 1990 年,但典型流量将根据近期的交通趋势(通常在过去的几个月中)进行计算。

要在适用的情况下使用实时流量,请选择当前时间 12 小时范围内的日期和时间。Esri会保存 12 小时的实时交通数据并参考 12 小时以后的预测数据。如果为此参数指定的时间和日期在 24 小时时间窗之外,或分析中的行驶时间继续超过预测数据窗,则任务将回退到典型流量速度。

Date
timeZoneForTimeOfDay
(可选)

指定所选时间的一个或多个时区。有两个选项可供选择:GeoLocal(默认)和 UTC。

  • GEOLOCAL时间值采用输入点所在的一个或多个时区。该选项会导致各时区中分析的起始时间有所变动。这是默认设置。
  • UTC时间值采用协调世界时间 (UTC)。无论时区差异,所有点的开始时间均应同步。
String
returnBoundaries
(可选)

指定是返回输入几何还是返回直线或出行模式缓冲区几何。

  • RETURN_BOUNDARIES输出图层将包含由指定邻近要素类型定义的区域。例如,如果使用 5 英里的直线距离,则输出中将包含输入邻近要素图层要素周围以 5 英里为半径的区域。这是默认设置。
  • RETURN_INPUT输出图层将包含与输入邻近要素图层相同的要素。
Boolean
sumShape
(可选)

根据输入汇总要素的形状计算统计数据,例如输入汇总图层中各个面内汇总要素线的长度或面的面积。

  • ADD_SHAPE_SUM计算形状汇总属性。这是默认设置。
  • NO_SHAPE_SUM不计算形状汇总属性。
Boolean
shapeUnits
(可选)

如果要汇总邻近要素的形状,请指定形状汇总的单位。

如果输入汇总要素为面,则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。

如果输入汇总要素为线,则有效选项为米、千米、英尺、码和英里。

  • MILES英里
  • FEET英尺
  • KILOMETERS千米
  • METERS
  • YARDS
  • ACRES英亩
  • HECTARES公顷
  • SQUAREMETERS平方米
  • SQUAREKILOMETERS平方千米
  • SQUAREFEET平方英尺
  • SQUAREYARDS平方码
  • SQUAREMILES平方英里
String
summaryFields
[[Field, Statistic],...]
(可选)

字段名称及您想要为各面内全部点计算的统计汇总类型的列表。始终返回每个面内的点计数。支持的统计数据类型如下:

  • SUM - 总值。
  • MIN - 最小值。
  • MAX - 最大值。
  • MEAN - 平均值。
  • STD - 标准差。

Value Table
groupByField
(可选)

这是输入汇总要素的一个字段,可用于分别计算每个唯一属性值的统计数据。例如,假设输入汇总要素包含存储危险材料的企业的点位置,且其中一个字段为 HazardClass,字段中含有用于描述所存储危险材料类型的代码。要根据每个 HazardClass 唯一值计算汇总,请将其用作分组条件字段。

Field
minorityMajority
(可选)

仅当使用分组条件字段时适用。如果指定了 ADD_MIN_MAJ,将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算。前缀为众数_少数_的两个新字段将添加至输出图层。

  • NO_MIN_MAJ不添加少数和众数字段。这是默认设置。
  • ADD_MIN_MAJ添加少数和众数字段。
Boolean
percentShape
(可选)

仅当使用分组条件字段时适用。如果选中,则系统将针对每个输入邻近要素计算各唯一组值的百分比。

  • NO_PERCENT不添加百分比字段。这是默认设置。
  • ADD_PERCENT添加百分比字段。
Boolean

派生输出

名称说明数据类型
resultLayer

输出汇总图层。

要素集
groupBySummary

如果提供了分组条件字段,则此工具将针对每个唯一组输出含有计算统计数据的表格。

记录集

环境

许可信息

  • Basic: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
  • Standard: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
  • Advanced: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限

相关主题