Condividi tramite


Funzione st_area

Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime 17.1 e versioni successive

Important

Questa funzionalità è in Anteprima Pubblica.

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Restituisce l'area del valore di input GEOGRAPHY o GEOMETRY.

Syntax

st_area ( geoExpr )

Arguments

  • geoExpr: un valore GEOGRAPHY o GEOMETRY.

Returns

Valore di tipo DOUBLE, che rappresenta l'area dell'input GEOGRAPHY o GEOMETRY del valore.

Se l'input è un GEOGRAPHY valore, la funzione restituisce l'area geodesica 2D del GEOGRAPHY valore . In particolare, la funzione restituisce l'area geodesica per i poligoni e la somma delle aree dei poligoni in un multipolygons. Per le geometrie non areali (punti, linestring, multipoint e multilinestring) viene restituito 0, mentre per le collezioni di geometria, la funzione restituisce la somma delle aree degli elementi della collezione. Il risultato viene calcolato eseguendo il calcolo geodesico inverso presupponendo l'ellissoide WGS84. Le unità del risultato sono metri quadrati.

Se l'input è un GEOMETRY valore, la funzione restituisce l'area cartesiana 2D del GEOMETRY valore. In particolare, la funzione restituisce l'area cartesiana 2D per i poligoni e la somma delle aree dei poligoni in un multipolygone. Per le geometrie non areali (punti, linee, multipunti e multilinee) viene restituito 0, mentre per le collezioni di geometrie restituisce la somma delle aree degli elementi dell'insieme. Le unità del risultato sono quelle del sistema di riferimento spaziale del valore di input GEOMETRY , quadrato.

La funzione restituisce NULL se uno degli input è 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