Teilen über

ST_AREA (NoSQL-Abfrage)

  • Artikel

GILT FÜR: NoSQL

Gibt den Gesamtbereich eines GeoJSON-Ausdrucks vom Typ Polygon oder MultiPolygon zurück.

Hinweis

Weitere Informationen finden Sie unter Räumliche Daten und GeoJSON-Standortdaten.

Syntax

ST_AREA(<spatial_expr>)

Argumente

BESCHREIBUNG
spatial_expr Beliebiger gültiger GeoJSON-Ausdruck vom Typ Polygon oder MultiPolygon.

Rückgabetypen

Gibt einen numerischen Ausdruck zurück, der die Gesamtfläche einer Gruppe von Punkten aufzählt.

Beispiele

Das folgende Beispiel zeigt, wie die Fläche eines Polygons zurückgegeben wird.

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 für das Standardreferenzsystem in Quadratmetern angegeben.
  • Die Verwendung dieser Funktion zum Berechnen der Fläche von Figuren ohne Dimension oder eindimensionalen Figuren wie GeoJSON-Objekte vom Typ Pointund LineString resultiert in einer Fläche von 0.
  • Die GeoJSON-Spezifikation erfordert, dass die Punkte innerhalb eines Polygons gegen den Uhrzeigersinn angegeben werden. Ein Polygon, das im Uhrzeigersinn angegeben wird, stellt die Umkehrung der darin enthaltenen Region dar.

Zugehöriger Inhalt