ST_AREA - Cosmos DB 中的查询语言

该 ST_AREA 函数返回 GeoJSON 多边形或 MultiPolygon 表达式的总面积。

该 ST_AREA 函数返回一个数值，表示 Azure Cosmos DB for NoSQL 中 GeoJSON 多边形或 MultiPolygon 的总面积。

Syntax

ST_AREA(<spatial_expr>)

Arguments

返回类型

返回一个数值表达式，该表达式枚举一组点的总面积。

例子

本部分包含有关如何使用此查询语言构造的示例。

计算多边形的面积

在此示例中，该 ST_AREA 函数用于返回 GeoJSON 多边形的区域。

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 点和 LineStrings 等零个或一维图形的区域会导致区域 0。
• GeoJSON 规范要求按逆时针顺序指定多边形中的点。 按顺时针顺序指定的多边形表示该区域内的反函数。