geometry-expression.ST_WithinDistance(geo2,distance[, unit-name])

ST_WithinDistance 方法检测两个几何间的最小距离是否超过指定距离，并考虑公差。

更确切地说，用 d 表示 geometry-expression 和 geo2 间的最小距离。如果 d <= distance 或者 d 超出 distance 的长度低于相关联空间参照系的公差，那么表达式 geometry-expression.ST_WithinDistance( geo2, distance[, unit_name]) 的值为 1。

对于平面空间参照系，所计算的距离为平面中的笛卡尔距离，计算时采用相关空间参照系的线性测量单位对于球形地球空间参照系，在计算距离时将考虑地球表面的曲率，方法为使用空间参照系定义中的椭圆体参数。

• 类型 ST_Geometry 的 ST_Distance 方法
• 类型 ST_Geometry 的 ST_WithinDistanceFilter 方法
• 类型 ST_Geometry 的 ST_Intersects 方法

以下示例返回一个排序结果集，其中每行对应于一个与点 (2,3) 的距离在 1.4 之内的 shape。

SELECT ShapeID, ROUND( Shape.ST_Distance( NEW ST_Point( 2, 3 ) ), 2 ) AS dist
FROM SpatialShapes 
WHERE ShapeID < 17
AND Shape.ST_WithinDistance( NEW ST_Point( 2, 3 ), 1.4 ) = 1
ORDER BY dist

该示例返回以下结果集：

以下示例创建表示加拿大诺瓦斯克提亚省哈利法克斯市和安大略省滑铁卢市的点，并使用 ST_WithinDistance 说明两个点间的距离在 850 英里内，而不是在 840 英里内。该示例假设已通过 sa_install_feature 系统过程安装了 'st_geometry_predefined_uom' 功能。请参见sa_install_feature 系统过程。

SELECT NEW ST_Point( -63.573566, 44.646244, 4326 )
	.ST_WithinDistance( NEW ST_Point( -80.522372, 43.465187, 4326 )
	                    , 850, 'Statute mile' ) within850,
	NEW ST_Point( -63.573566, 44.646244, 4326 )
	.ST_WithinDistance( NEW ST_Point( -80.522372, 43.465187, 4326 )
	                    , 840, 'Statute mile' ) within840

该示例返回以下结果集：