返回顶部

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

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

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

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

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

插图

“邻近汇总”工具示意图

使用情况

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

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

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

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

参数

对话框Python

标注说明数据类型
输入邻近要素图层

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

Feature Set
输入汇总要素

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

Feature Set
输出名称

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

String
距离测量

指定将使用的距离测量方法：按直线距离进行测量，或利用多种交通方式（称为出行模式）通过测量沿街道网络的行驶时间或行驶距离来进行测量。

  • 直线—将使用直线欧式距离测量法。 这是默认设置。
  • 行驶距离—将使用乘坐汽车的行驶距离。
  • 行驶时间—将使用指定行驶时间内乘坐汽车的行驶距离。
  • 货运距离—将使用乘坐货车的行驶距离。
  • 货运时间—将使用指定行驶时间内乘坐货车的行驶距离。
  • 步行距离—将使用沿街道行走的距离。
  • 步行时间—将使用指定时间内的行走距离。
String
距离
(可选)

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

Double
距离单位
(可选)

如果距离为基于直线或基于距离的出行模式，则此单位为将与距离参数中指定的距离值一同使用的线性单位。 选项包括英里、英尺、千米、米和码。

如果距离为基于时间的出行模式，则选项包括秒、分钟和小时。

  • 英里—单位将为英里。
  • 英尺—单位将为英尺。
  • 千米—单位将为千米。
  • 米—单位将为米。
  • 码—单位将为码。
  • 秒—单位为秒。
  • 分—单位为分钟。
  • 小时—单位为小时。
String
时间
(可选)

行驶时间的时间和日期将考虑交通状况。 要在分析中使用流量，必须将距离设置为基于出行时间的模式。 时间值表示出行开始（或从输入点离开）的时间。

支持两种类型的流量：典型流量和实时流量。 典型流量将参考行驶速度，该速度由一周内每 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
时区
(可选)

指定时区或指定时间的时区。

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

指定是否将返回输入几何、直线或出行模式缓冲几何。

  • 选中 - 输出图层将包含由距离测量参数值定义的区域。 例如，如果使用 5 英里的直线距离，则输出中将包含输入邻近要素图层要素周围以 5 英里为半径的区域。 这是默认设置。
  • 未选中 - 输出图层将包含与输入邻近图层中相同的要素。

Boolean
添加形状汇总属性
(可选)

指定是否将根据输入汇总要素参数值（例如输入汇总图层中每个面内汇总要素的线的长度或面的面积）的形状计算统计数据。

  • 选中 - 将根据形状汇总属性计算统计数据。 这是默认设置。
  • 未选中 - 不会根据形状汇总属性计算统计数据。

Boolean
形状单位
(可选)

指定将用于形状汇总的单位。

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

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

  • 英里—单位将为英里。
  • 英尺—单位将为英尺。
  • 千米—单位将为千米。
  • 米—单位将为米。
  • 码—单位将为码。
  • 英亩—将以英亩为单位。
  • 公顷—单位将为公顷。
  • 平方米—单位将为平方米。
  • 平方千米—单位将为平方公里。
  • 平方英尺—将以平方英尺为单位。
  • 平方码—将以平方码为单位。
  • 平方英里—将以平方英里为单位。
String
汇总字段
(可选)

字段名称及要为各面内全部点计算的统计汇总类型的列表。 始终返回每个面内的点计数。

支持的统计数据类型如下：

  • 总和 - 将计算总值。
  • 最小值 - 将确定最小值。
  • 最大值 - 将确定最大值。
  • 平均值 - 将计算平均值。
  • 标准差 - 将计算标准差。

Value Table
分组依据字段
(可选)

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

Field
添加少数和众数属性
(可选)

指定是否向输出添加少数和众数字段。

此参数仅当使用按字段分组时适用。

  • 未选中 - 不会向输出添加少数和众数字段。 这是默认设置。
  • 选中 - 将对各个边界内每个组字段的少数（所占比例最小）或众数（所占比例最大）属性值进行计算，并将前缀为 Minority_ 和 Majority_ 的两个新字段添加至输出。

Boolean
添加组百分比
(可选)

指定是否将组百分比字段添加至输出。

此参数仅当使用按字段分组时适用。

  • 未选中 - 不会将百分比字段添加至输出。 这是默认设置。
  • 选中 - 将针对每个输入邻近要素计算每个唯一组百分比值，并将百分比字段添加至输出。

Boolean

派生输出

标注说明数据类型
输出要素服务

输出已汇总图层。

Feature Set
输出分组表

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

Record Set

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 参数值提供。

Double
units
(可选)

如果距离为基于直线或基于距离的出行模式，则此单位为将与 distances 参数中指定的距离值一同使用的线性单位。 选项包括英里、英尺、千米、米和码。

如果距离为基于时间的出行模式，则选项包括秒、分钟和小时。

  • 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—时间值采用协调世界时间 (UTC)。 无论时区差异，所有点的开始时间均应同步。
String
returnBoundaries
(可选)

指定是否将返回输入几何、直线或出行模式缓冲几何。

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

指定是否将根据 summaryLayer 参数值（例如输入汇总图层中每个面内汇总要素的线的长度或面的面积）的形状计算统计数据。

  • 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
(可选)

指定是否向输出添加少数和众数字段。

此参数仅当使用按字段分组时适用。

  • NO_MIN_MAJ—不会向输出添加少数和众数字段。 这是默认设置。
  • ADD_MIN_MAJ—将对各个边界内每个组字段的少数（所占比例最小）或众数（所占比例最大）属性值进行计算，并将前缀为 Minority_ 和 Majority_ 的两个新字段添加至输出。
Boolean
percentShape
(可选)

指定是否将组百分比字段添加至输出。

此参数仅当使用按字段分组时适用。

  • NO_PERCENT—不会将百分比字段添加至输出。 这是默认设置。
  • ADD_PERCENT—将针对每个输入邻近要素计算每个唯一组百分比值，并将百分比字段添加至输出。
Boolean

派生输出

名称说明数据类型
resultLayer

输出已汇总图层。

Feature Set
groupBySummary

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

Record Set

环境

范围

许可信息

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

相关主题

  • 汇总数据工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息