使用说明
空间查询DSF根据指定的空间关系,查询DSF数据集中所有满足要求的对象,查询和待查询数据集均为地理分区要素数据集(DSFFeatureRDD)。仅能够输入SuperMap DSF数据格式的数据集。
分布式空间查询提供【空间查询】和【空间查询DSF】两种功能,区别在于查询和待查询的数据集类型不同。
DSF是一种为分布式计算优化过的矢量数据存储方式,能够显著提高大数据量的计算性能,在千万级及以上数据的空间查询中更推荐此种方法。
空间关系判断类型
空间关系判断类型,即连接数据对目标数据的空间关系,分布式空间查询支持的空间关系判断类型为Contain, Within, Intersected, InnerIntersected, Overlap,Identical, Disjointed, Touch, Cross, Near。
-
包含Contain:包含关系,返回待查询对象中所有被查询对象包含的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
被包含Within:被包含关系,返回待查询对象中完全包含被查询对象的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
图为被包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
相交Intersected:相交关系,返回待查询对象中所有与查询对象相交的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
图为被包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
- 内部相交InnerIntersected — 内部相交关系,返回与查询对象相交但不是仅接触的所有对象。也就是在相交算子的结果之上排除所有接触算子的结果。
-
重叠Overlap — 叠加关系。 返回待查询对象中与查询对象部分重叠的对象。
该关系适合的对象类型为:线/线,面/面
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
一致Identical — 一致关系。返回待查询对象中与查询对象完全重合的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
相离Disjointed:相离关系, 返回待查询对象中与查询对象相离的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
接触Touch :邻接关系。返回待查询对象中其边界与查询对象边界相触的对象。
该关系不适合的对象类型为:点查询点的空间关系。
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
交叉Cross: 交叉关系。返回待查询对象中与查询对象(线)相交的所有对象(线或面)。
该关系适合的对象类型:查询对象: 线;待查询对象: 线、面。
图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。
-
邻近Near: 邻近关系,返回待查询对象中与查询对象间的距离小于指定距离的对象。
该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。
参数说明
参数名 | 默认值 | 参数释义 | 参数类型 |
---|---|---|---|
查询数据集 | 查询数据集,支持点、线和面数据集 | DSFFeatureRDD | |
被查询数据集 | 被查询数据集,支持点、线和面数据集 | DSFFeatureRDD | |
空间关系判断类型 | 空间关系判断类型,连接数据对目标数据的空间关系,支持Contain, Within, Intersected, InnerIntersected, Overlap,Identical, Disjointed, Touch, Cross, Near | JavaSpatialRelationType | |
结果数据集中是否保留目标数据集的属性字段 (可选) |
true | 结果数据集中是否保留目标数据集的属性字段,默认为true | Boolean |
结果数据集中是否保留目标数据集的空间几何信息 (可选) |
true | 结果数据集中是否保留目标数据集的空间几何信息,默认为true | Boolean |
是否存储查询对象的ID (可选) |
false | 是否存储查询对象的ID | Boolean |
存储查询对象 featureID 的字段名称 (可选) |
如果 saveQueryID 为true时,存储查询对象 featureID 的字段名称 | String | |
节点容限 (可选) |
0.0 | 节点容限。如果查询关系为 Near 时,表示邻近距离,如果为其他查询关系时,表示节点容限。当容限小于 1.0e-10 时,如果数据集的坐标系为地理坐标系时,将使用1.0e-7 的节点容限,当坐标系为空或投影坐标系时,使用 1.0e-2 的节点容限。 | Double |