适用范围: 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 规范要求多边形内的点按逆时针顺序指定。 以顺时针顺序指定的多边形表示其中的区域倒转。