空间连接
1.描述
根据空间关系将一个要素类的属性连接到另一个要素类的属性。目标要素和来自连接要素的被连接属性写入到输出要素类。
2.使用限制
3.算子id
igis.gis.analysis.overlay.spatial_join
4.参数列表
参数类型 |
参数名称 |
参数关键字 |
必要性 |
参数说明 |
数据类型 |
输入参数 |
url |
数据源地址 |
Y |
数据源地址 |
String |
target_features |
目标要素类 |
Y |
目标要素的属性和被连接要素的属性被传递到输出要素类。但是,可以在字段映射参数中定义属性的子集 |
String |
|
join_features |
连接属性 |
Y |
连接要素的属性将被连接到目标要素的属性中。有关连接操作的类型对所连接属性聚合的影响的详细信息 |
String |
|
join_operation |
连接方式 |
N |
在具有相同空间关系的目标要素和连接要素之间存在一对多关系时,确定输出要素类中目标要素和连接要素之间的连接方式 |
String |
|
join_type |
连接类型 |
N |
确定是在输出要素类中保留所有目标要素(称为外部连接),还是仅保留那些与连接要素有指定空间关系的目标要素(称为内部连接 |
Boolean |
|
field_mapping |
连接属性 |
N |
控制输出要素类中要包含的属性字段。初始列表包含目标要素和连接要素中的所有字段。可以添加、删除、重命名字段或更改字段的属性 |
String |
|
match_option |
匹配条件 |
N |
匹配条件 |
String |
|
search_radius |
搜索半径 |
N |
果连接要素与目标要素的距离在此范围内,则有可能进行空间连接。仅当将空间关系(匹配选项)指定为 INTERSECT、WITHIN_A_DISTANCE、WITHIN_A_DISTANCE_GEODESIC、HAVE_THEIR_CENTER_IN、CLOSEST 或 CLOSEST_GEODESIC 时,搜索半径才有效。当搜索半径设为 100 米时,使用空间关系 WITHIN_A_DISTANCE 将会连接距离目标要素 100 米以内的要素。对于这三种 WITHIN_A_DISTANCE 关系而言,如果未指定搜索半径的值,则距离将为 0 |
String |
|
distance_field_name |
输出字段 |
N |
添加到输出要素类中的字段的名称,其中包含目标要素和最近连接要素之间的距离。仅当将空间关系(匹配选项)指定为 CLOSEST 或 CLOSEST_GEODESIC 时,此选项才有效。如果在搜索半径内没有任何匹配的要素,则此字段的值为 -1。如果未指定字段名称,将不会向输出要素类中添加该字段 |
String |
|
输出参数 |
out_feature_class |
结果图层 |
Y |
包含目标要素和连接要素的属性的新要素类。默认情况下,目标要素的所有属性和被连接要素的属性都被写入到输出。但是,可通过字段映射参数来控制要传递的属性集 |
String |
5.配置面板
6.调用示例
{
"params": {
"url":"kudu://172.20.20.11:7051/geomesa_mc_test",
"target_features":"hainan",
"join_features":"hainan",
"join_operation":"JOIN_ONE_TO_ONE",
"field_mapping":"XZDM",
"match_option":"INTERSECT",
"out_feature_class":"hainan_spatial_join"
},
"identifier":"igis.gis.analysis.overlay.spatial_join"
}