ST_AREA - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die ST_AREA Funktion gibt den Gesamtbereich eines GeoJSON Polygon- oder MultiPolygon-Ausdrucks zurück.

Die ST_AREA Funktion gibt einen numerischen Wert zurück, der den Gesamtbereich eines GeoJSON-Polygons oder MultiPolygons in Azure Cosmos DB für NoSQL darstellt.

Syntax

ST_AREA(<spatial_expr>)

Arguments

Rückgabetypen

Gibt einen numerischen Ausdruck zurück, der den Gesamtbereich einer Reihe von Punkten aufzählt.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Berechnen des Bereichs eines Polygons

In diesem Beispiel wird die ST_AREA Funktion verwendet, um den Bereich eines GeoJSON-Polygons zurückzugeben.

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

Bemerkungen

• Das Ergebnis wird in Quadratmetern für das Standardreferenzsystem ausgedrückt.
• Die Verwendung dieser Funktion zum Berechnen des Bereichs null oder eindimensionaler Zahlen wie GeoJSON Points und LineStrings führt zu einem Bereich von 0.
• Die GeoJSON-Spezifikation erfordert, dass Punkte innerhalb eines Polygons in gegen den Uhrzeigersinn angegeben werden. Ein im Uhrzeigersinn angegebenes Polygon stellt die Umkehrung des Bereichs darin dar.