ST_DISTANCE (Azure Cosmos DB)

适用于:SQL API

返回两个 GeoJSON Point、Polygon、MultiPolygon 或 LineString 表达式之间的距离。 若要了解详细信息,请参阅地理空间和 GeoJSON 位置数据一文。

语法

ST_DISTANCE (<spatial_expr>, <spatial_expr>)  

参数

spatial_expr
是任何有效的 GeoJSON 点、多边形或 LineString 对象表达式。

返回类型

返回包含距离的一个数字表达式。 这是根据默认参考系统以米为单位表示的。

示例

以下示例演示了如何使用 ST_DISTANCE 内置函数返回与指定位置的距离在 30 公里内的所有家族文档。 .

SELECT f.id
FROM Families f
WHERE ST_DISTANCE(f.location, {'type': 'Point', 'coordinates':[31.9, -4.8]}) < 30000  

下面是结果集。

[{  
  "id": "WakefieldFamily"  
}]  

备注

此系统函数将从地理空间索引中受益,但包含聚合的查询除外。

注意

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

后续步骤