ST_ISVALID (Azure Cosmos DB)

适用于:SQL API

返回一个布尔值,该值指示指定的 GeoJSON 点、多边形、多多边形或 LineString 表达式是否有效。

语法

ST_ISVALID(<spatial_expr>)  

参数

spatial_expr
是 GeoJSON 点、多边形或 LineString 表达式。

返回类型

返回一个布尔表达式。

示例

以下示例介绍了如何使用 ST_VALID 检查点是否有效。

例如,由于此点具有一个不在有效值范围 [-90,90] 内的纬度值,因此查询返回 false。

对于多边形,GeoJSON 规范要求提供的最后一个坐标対应该与第一个坐标对相同,才能创建一个闭合形状。 多边形内的点必须以逆时针顺序指定。 以顺时针顺序指定的多边形表示其中的区域倒转。

SELECT ST_ISVALID({ "type": "Point", "coordinates": [31.9, -132.8] }) AS b 

下面是结果集:

[{ "b": false }]  

注意

GeoJSON 规范要求多边形内的点按逆时针顺序指定。 以顺时针顺序指定的多边形表示其中的区域倒转。

后续步骤