ST_AREA – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen ST_AREA returnerar det totala området för ett GeoJSON Polygon- eller MultiPolygon-uttryck.

Funktionen ST_AREA returnerar ett numeriskt värde som representerar det totala området för en GeoJSON Polygon eller MultiPolygon i Azure Cosmos DB för NoSQL.

Syntax

ST_AREA(<spatial_expr>)

Arguments

	Description
spatial_expr	Alla giltiga GeoJSON Polygon- eller MultiPolygon-uttryck.

Returtyper

Returnerar ett numeriskt uttryck som räknar upp den totala ytan för en uppsättning punkter.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Beräkna området för en polygon

I det här exemplet ST_AREA används funktionen för att returnera området för en GeoJSON-polygon.

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
  }
]

Anmärkningar

• Resultatet uttrycks i kvadratmeter för standardreferenssystemet.
• Om du använder den här funktionen för att beräkna området med noll- eller endimensionella figurer som GeoJSON-punkter och LineStrings resulterar det i ett område med 0.
• GeoJSON-specifikationen kräver att punkter i en Polygon anges i motsols ordning. En Polygon som anges i medsols ordning representerar inversen av regionen inom den.