ST_AREA(NoSQL 查询)

适用范围: NoSQL

返回 GeoJSON PolygonMultiPolygon 表达式的总面积。

注意

有关详细信息,请参阅 Geospatial 和 GeoJSON 位置数据

语法

ST_AREA(<spatial_expr>)

参数

说明
spatial_expr 任何有效的 GeoJSON PolygonMultiPolygon 表达式。

返回类型

返回数值表达式,其枚举一组点的总面积。

示例

以下示例显示了如何返回多边形的面积。

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 PointLineString)的面积会产生 0 的面积。
  • GeoJSON 规范要求多边形内的点按逆时针顺序指定。 以顺时针顺序指定的多边形表示其中的区域倒转。