Teilen über

st_area-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt den Bereich der Eingabe zurück GEOGRAPHY oder GEOMETRY Wert.

Syntax

st_area ( geoExpr )

Arguments

  • geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert.

Returns

Ein Wert vom Typ DOUBLE, der den Bereich der Eingabe GEOGRAPHY oder GEOMETRY des Werts darstellt.

Wenn die Eingabe ein GEOGRAPHY Wert ist, gibt die Funktion den geodätischen 2D-Bereich des Werts GEOGRAPHY zurück. Insbesondere gibt die Funktion den geodätischen Bereich für Polygone und die Summe der Bereiche der Polygone in einem Multipolygon zurück. Bei nicht-flächenhaften Geometrien (Punkte, Linien, Multipunkte und Multilinien) wird 0 zurückgegeben, während die Funktion für Geometriesammlungen die Summe der Flächen der Elemente in der Sammlung zurückgibt. Das Ergebnis wird berechnet, indem die inverse geodätische Berechnung auf Grundlage des WGS84-Ellipsoids durchgeführt wird. Die Einheiten des Ergebnisses sind Quadratmeter.

Wenn es sich bei der Eingabe um einen GEOMETRY Wert handelt, gibt die Funktion den 2D Cartesian-Bereich des GEOMETRY Werts zurück. Insbesondere gibt die Funktion den 2D-kartesischen Bereich für Polygone und die Summe der Bereiche der Polygone in einem Multipolygon zurück. Für nicht-areale Geometrien (Punkte, Linienzeichenfolgen, Multipoints und mehrzeilige Zeichenfolgen) wird 0 zurückgegeben, während für Geometrieauflistungen die Summe der Bereiche der Elemente in der Auflistung zurückgegeben wird. Die Einheiten des Ergebnisses sind die Einheiten des räumlichen Bezugssystems des Eingabewerts GEOMETRY , quadratisch.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Examples

-- Returns the area of a 2D Cartesian polygon with a hole.
> SELECT st_area(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))'));
  2450.0
  • Last updated on