funktion st_area

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Returnerar området för indata GEOGRAPHY eller GEOMETRY värde.

Syntax

st_area ( geoExpr )

Arguments

  • geoExpr: Ett GEOGRAPHY- eller GEOMETRY-värde.

Returns

Ett värde av typen DOUBLE, som representerar området för indata GEOGRAPHY eller GEOMETRY värde.

Om indata är ett GEOGRAPHY värde returnerar funktionen det geodesiska 2D-området för GEOGRAPHY värdet. Mer specifikt returnerar funktionen det geodesiska området för polygoner och summan av polygonernas områden i en multipolygon. För icke-areala geografiska områden (punkter, linjer, multipunkter och multilinestrings) returneras 0, medan för geometrisamlingar returnerar funktionen summan av områdena för elementen i samlingen. Resultatet beräknas genom att utföra den geodesiska omvända beräkningen med förutsättningen att WGS84-ellipsoiden används. Resultatets enheter är kvadratmeter.

Om indata är ett GEOMETRY värde returnerar funktionen värdets 2D-kartesiska område GEOMETRY . Mer specifikt returnerar funktionen det 2D-kartesiska området för polygoner och summan av polygonernas områden i en multipolygon. För icke-arealgeometrier (punkter, linjer, multipunkter och multilinestrings) returneras 0, medan den för geometrisamlingar returnerar summan av elementens områden i samlingen. Resultatets enheter är de i det rumsliga referenssystemet för indatavärdet GEOMETRY i kvadrat.

Funktionen returnerar NULL om någon av indata är 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