空间查询DSF

使用说明

空间查询DSF根据指定的空间关系,查询DSF数据集中所有满足要求的对象,查询和待查询数据集均为地理分区要素数据集(DSFFeatureRDD)。仅能够输入SuperMap DSF数据格式的数据集。

分布式空间查询提供【空间查询】和【空间查询DSF】两种功能,区别在于查询和待查询的数据集类型不同。

DSF是一种为分布式计算优化过的矢量数据存储方式,能够显著提高大数据量的计算性能,在千万级及以上数据的空间查询中更推荐此种方法。

空间关系判断类型

空间关系判断类型,即连接数据对目标数据的空间关系,分布式空间查询支持的空间关系判断类型为Contain, Within, Intersected, InnerIntersected, Overlap,Identical, Disjointed, Touch, Cross, Near。

  • 包含Contain:包含关系,返回待查询对象中所有被查询对象包含的对象。

    该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQContain

  • 被包含Within:被包含关系,返回待查询对象中完全包含被查询对象的对象。

    该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。

    图为被包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQWithin

  • 相交Intersected:相交关系,返回待查询对象中所有与查询对象相交的对象。

    该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。

    图为被包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQIntersect

  • 内部相交InnerIntersected — 内部相交关系,返回与查询对象相交但不是仅接触的所有对象。也就是在相交算子的结果之上排除所有接触算子的结果。
  • 重叠Overlap — 叠加关系。 返回待查询对象中与查询对象部分重叠的对象。

    该关系适合的对象类型为:线/线,面/面

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQOverlap

  • 一致Identical — 一致关系。返回待查询对象中与查询对象完全重合的对象。

    该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQIdentical

  • 相离Disjointed:相离关系, 返回待查询对象中与查询对象相离的对象。

    该关系适合的对象类型:查询对象: 点、线、面;待查询对象: 点、线、面。

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQDsjoint

  • 接触Touch :邻接关系。返回待查询对象中其边界与查询对象边界相触的对象。

    该关系不适合的对象类型为:点查询点的空间关系。

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQTouch

  • 交叉Cross: 交叉关系。返回待查询对象中与查询对象(线)相交的所有对象(线或面)。

    该关系适合的对象类型:查询对象: 线;待查询对象: 线、面。

    图为包含空间查询图示,其中查询对象用绿色表示,待查询对象用黑色表示,结果返回几何对象用红色表示。

    SQCross

  • 邻近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