| 包 | com.supermap.web.iServerJava2.queryServices |
| 类 | public class SpatialQueryMode |
| 继承 | SpatialQueryMode  Object |
空间查询是通过几何对象之间的空间位置关系来构建过滤条件的一种查询方式。例如：通过空间查询可以找到被包含在面中的空间对象，相离或者相邻的空间对象等。当前版本提供对点、线、面和文本类型数据的空间查询，其中文本类型仅支持相交和包含两种空间查询模式，而且只能作为被搜索对象不能作为搜索对象。对每个枚举值给出了图例，其中黑色代表搜索对象、绿色代表被搜索对象、红色表示搜索结果。
点、线、面空间几何对象都有明确的边界矩形、边界、内部和外部。几何对象的空间位置关系比较，实质上就是对相互间边界矩形、边界、内部和外部关系的比较。
| 几何对象 | 边界矩形（Boundary or Extent） | 边界（Outline） | 内部（Interior） | 外部（Exterior） |
| 点 | 无 | 无 | 点对象本身 | 点对象本身外的区域 |
| 线 | 线对象的最小外接矩形 | 线对象的端点 | 线对象本身除去端点的部分 | 线对象本身外的区域 |
| 面 | 面对象的最小外接矩形 | 面对象控制边的并集 | 面对象边界围成的区域 | 面对象本身外的区域 |
| 方法 | 定义方 | ||
|---|---|---|---|
|
初始化 SpatialQueryMode 类的新实例。
|
SpatialQueryMode | ||
| 常量 | 定义方 | ||
|---|---|---|---|
| CONTAIN : int = 7
[static] 包含空间查询模式，对应值为7。
返回被搜索图层中完全被搜索对象包含的对象。搜索对象和被搜索对象的边界交集可以不为空；点查线/点查面/线查面，不存在包含情况。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| CROSS : int = 5
[static] 交叉空间查询模式，对应值为5。
返回被搜索图层中与搜索对象相交的所有对象。搜索对象和被搜索对象内部的交集不能为空；参与交叉（Cross）关系运算的两个对象必须有一个是线对象。该关系适合的对象类型：搜索对象——线；被搜索对象——线、面。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| DISJOINT : int = 1
[static] 分离空间查询模式，对应值为1。
返回被搜索图层中与搜索对象相离的对象。搜索对象和被搜索对象相离，即无任何交集。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| IDENTITY : int = 0
[static] 重合空间查询模式，对应值为0。
返回被搜索图层中与搜索对象完全重合的对象，包括对象类型和坐标。搜索对象与被搜索对象的类型必须相同；且两个对象的交集不为空，搜索对象的边界及内部分别和被搜索对象的外部交集为空。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| INTERSECT : int = 2
[static] 相交空间查询模式，对应值为2。
返回与搜索对象相交的所有对象。如果搜索对象是面，返回全部或部分被搜索对象包含的对象以及全部或部分包含搜索对象的对象；如果搜索对象不是面，返回全部或部分包含搜索对象的对象。该关系适合的对象类型：搜索对象：点、线、面；被搜索对象：点、线、面。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| NONE : int = -1
[static] 无空间查询，对应值为-1。
|
SpatialQueryMode | ||
| OVERLAP : int = 4
[static] 叠加空间查询模式，对应值为4。
返回被搜索图层中与搜索对象部分重叠的对象。该关系适合的对象类型为：线/线，面/面。其中，两个几何对象的维数必须一致，而且他们交集的维数也应该和几何对象的维数一样。点与任何一种几何对象都不存在部分重叠的情况。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| TOUCH : int = 3
[static] 邻接空间查询模式,对应值为3。
返回被搜索图层中其边界与搜索对象边界相触的对象。搜索对象和被搜索对象的内部交集为空。该关系不适合的对象类型为：点查询点的空间关系。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| WITHIN : int = 6
[static] 被包含空间查询模式，对应值为6。
返回被搜索图层中完全包含搜索对象的对象。如果返回的对象是面，其必须全部包含（包括边接触）搜索对象；如果返回的对象是线，其必须完全包含搜索对象；如果返回的对象是点，其必须与搜索对象重合。该类型与包含（Contain）的查询模式正好相反。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。线查询点，面查询线或面查询点都不存在被包含的情况。 几何对象 边界矩形（Boundary or Extent） |
SpatialQueryMode | ||
| SpatialQueryMode | () | 构造函数 |
public function SpatialQueryMode()
初始化 SpatialQueryMode 类的新实例。
| CONTAIN | 常量 |
public static const CONTAIN:int = 7
包含空间查询模式，对应值为7。
返回被搜索图层中完全被搜索对象包含的对象。搜索对象和被搜索对象的边界交集可以不为空；点查线/点查面/线查面，不存在包含情况。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
 |
 |
 |
|
 |
 |
||
 |
 |
 |
|
 |
 |
 |
 |
| CROSS | 常量 |
public static const CROSS:int = 5
交叉空间查询模式，对应值为5。
返回被搜索图层中与搜索对象相交的所有对象。搜索对象和被搜索对象内部的交集不能为空；参与交叉（Cross）关系运算的两个对象必须有一个是线对象。该关系适合的对象类型：搜索对象——线；被搜索对象——线、面。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
|||
|
 |
 |
|
|
| DISJOINT | 常量 |
public static const DISJOINT:int = 1
分离空间查询模式，对应值为1。
返回被搜索图层中与搜索对象相离的对象。搜索对象和被搜索对象相离，即无任何交集。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
 |
 |
 |
|
 |
 |
 |
|
 |
 |
 |
| IDENTITY | 常量 |
public static const IDENTITY:int = 0
重合空间查询模式，对应值为0。
返回被搜索图层中与搜索对象完全重合的对象，包括对象类型和坐标。搜索对象与被搜索对象的类型必须相同；且两个对象的交集不为空，搜索对象的边界及内部分别和被搜索对象的外部交集为空。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
 |
||
|
 |
||
|
 |
| INTERSECT | 常量 |
public static const INTERSECT:int = 2
相交空间查询模式，对应值为2。
返回与搜索对象相交的所有对象。如果搜索对象是面，返回全部或部分被搜索对象包含的对象以及全部或部分包含搜索对象的对象；如果搜索对象不是面，返回全部或部分包含搜索对象的对象。该关系适合的对象类型：搜索对象：点、线、面；被搜索对象：点、线、面。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
 |
 |
 |
|
|||
|
 |
 |
 |
| NONE | 常量 |
public static const NONE:int = -1
无空间查询，对应值为-1。
| OVERLAP | 常量 |
public static const OVERLAP:int = 4
叠加空间查询模式，对应值为4。
返回被搜索图层中与搜索对象部分重叠的对象。该关系适合的对象类型为：线/线，面/面。其中，两个几何对象的维数必须一致，而且他们交集的维数也应该和几何对象的维数一样。点与任何一种几何对象都不存在部分重叠的情况。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
|||
|
 |
||
|
 |
| TOUCH | 常量 |
public static const TOUCH:int = 3
邻接空间查询模式,对应值为3。
返回被搜索图层中其边界与搜索对象边界相触的对象。搜索对象和被搜索对象的内部交集为空。该关系不适合的对象类型为：点查询点的空间关系。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
 |
 |
|
|
 |
 |
 |
|
 |
 |
 |
| WITHIN | 常量 |
public static const WITHIN:int = 6
被包含空间查询模式，对应值为6。
返回被搜索图层中完全包含搜索对象的对象。如果返回的对象是面，其必须全部包含（包括边接触）搜索对象；如果返回的对象是线，其必须完全包含搜索对象；如果返回的对象是点，其必须与搜索对象重合。该类型与包含（Contain）的查询模式正好相反。该关系适合的对象类型：搜索对象——点、线、面；被搜索对象——点、线、面。线查询点，面查询线或面查询点都不存在被包含的情况。
| 几何对象 | 边界矩形（Boundary or Extent） | ||
|
|
|
|
|
 |
 |
 |
|
 |
 |
|
|
 |