你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
ST_AREA（NoSQL 查询）
适用范围：
NoSQL
返回 GeoJSON Polygon 或 MultiPolygon 表达式的总面积。
注意
有关详细信息，请参阅 Geospatial 和 GeoJSON 位置数据。
语法
ST_AREA(<spatial_expr>)
参数
| 说明 | |
|---|---|
spatial_expr |
任何有效的 GeoJSON Polygon 或 MultiPolygon 表达式。 |
返回类型
返回数值表达式，其枚举一组点的总面积。
示例
以下示例显示了如何返回多边形的面积。
SELECT VALUE {
areaPolygon: ST_AREA({
"type": "Polygon",
"coordinates": [ [
[ 31.8, -5 ],
[ 32, -5 ],
[ 32, -4.7 ],
[ 31.8, -4.7 ],
[ 31.8, -5 ]
] ]
})
}
[
{
"areaPolygon": 735970283.0522614
}
]
注解
- 默认引用系统的结果以平方米表示。
- 使用此函数计算零或一维图形（如 GeoJSON Point 和 LineString）的面积会产生
0的面积。 - GeoJSON 规范要求多边形内的点按逆时针顺序指定。 以顺时针顺序指定的多边形表示其中的区域倒转。