专业类API 邻近汇总
邻近汇总
此工具用于在第一个输入图层中查找位于距选定要素指定距离内的要素并进行汇总。可以按直线距离或使用所选出行模式测量距离。出行模式选项包括:行驶距离、行驶时间、货运距离、货运时间、步行距离或步行时间。然后,计算邻近要素的统计数据。
服务操作列表
邻近汇总(SummarizeNearby)接口主要包括,其说明如下表。
操作 描述
submitJob 提交分析数据以及设置相应的参数到服务器进行分析。
服务操作的参数列表

SummarizeNearby操作请求方法实现参数

参数名称 参数个数 参数类型和值
sumNearbyLayer 1个(必选) 将用于作为起始位置汇总邻近要素的点图层、线图层或区域图层。该工具支持此图层中最多包含 1,000 个要素。
summaryLayer 1个(必选) 将汇总此图层中与上述指定图层中的要素相距指定距离的要素。
nearType 1个(可选) 您可以定义要使用的距离测量方式:直线距离或所选出行模式。行驶模式仅在第一个输入图层(自其测量距离的图层)包含点时启用。使用某一个出行模式时,将沿着道路或人行道进行测量,并且支持适用的规则,例如单行道和违章转弯等。行驶时间支持您选择基于实时流量或典型流量的行驶速度。实时速度通过当前的传感器读数进行收集,典型速度通过计算历史平均值得出。
distances 1个(必选) 您可以输入多个距离。汇总处于您所输入距离内(包含该距离)的要素。
units 1个(可选) 距离的单位。
timeOfDay 1个(可选) 设置日期和时间。
timeZoneForTimeOfDay 1个(可选) 设置日期和时间的基准。
returnBoundaries 1个(可选) 如果设置为true,将返回由指定距离测量结果定义的区域的结果图层。结果图层将包括所有请求的汇总信息。如果为false,生成的图层将返回第一个输入图层的相同要素以及所有请求的汇总信息。
sumShape 1个(可选) 是否计算待汇总要素的空间信息,根据要汇总的要素类型,您可以计算点的总数、线的总长度或总面积。
shapeUnits 1个(可选) 当指定要计算待汇总要素的空间信息时生效,指定计算的单位。
summaryFields 1个(可选) 选择要汇总的图层后,您还可以计算所有附近点、线或面的数值属性的统计数据。例如:[“fieldname1 summary”,“fieldname2 summary”]
groupByField 1个(可选) 这是邻近要素的一个属性,可用于分别计算每个唯一属性值的统计数据。
minorityMajority 1个(可选) 选择作为分组依据的字段时,将启用此复选框。如果想要了解指定距离或时间内各组中的哪些属性值为少数(所占比例最小)或多数(所占比例最大),请选择 添加少数、多数。选择 添加少数、多数后,两个新字段将添加到结果图层。如果同时选择 添加百分比,则会有两个额外字段添加到结果图层,其中包含每组内少数属性值和多数属性值所占的百分比。 如果对邻近点进行汇总,则少数值和多数值将根据指定距离或时间内的点数进行计算。 如果对邻近线进行汇总,则少数值和多数值将根据指定距离或时间内的线长度进行计算。 如果对邻近区域进行汇总,则少数值和多数值将根据指定距离或时间内的面积进行计算。
percentShape 1个(可选) 选择作为分组依据的字段时,将启用此复选框。如果想要了解每组内每个属性值所占的百分比,可选择 添加百分比。向结果表添加一个新字段,其中包含每组内每个属性值所占的百分比。如果也选中了 添加少数、多数,则会有两个额外字段添加到结果图层,其中包含每组内少数属性值和多数属性值所占的百分比。
outputName 1个(可选) 若想保存分析结果,需输入结果命名。
context 1个(可选) 额外设置:例如分析的范围、输出的参考系等。
接口调用地址
接口名称 调用地址
SummarizeNearby