st_area-Funktion

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

Important

Unterstützung für GEOGRAFIE-Werte befindet sich in der öffentlichen Vorschau. Die Unterstützung für GEOMETRY-Werte ist allgemein verfügbar.

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