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

描述

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

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

• 计算在建议的新商店位置 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,...] （可选）	定义搜索距离（针对直线和基于距离的出行模式）或时间（针对基于时间的出行模式）的双精度值列表。可以输入一个距离值或多个距离值。汇总处于您所输入距离内（包含该距离）的要素。距离值的 units 由 units 参数提供。	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 中的帐户有执行分析的权限