STArea (geography-Datentyp)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Gibt die gesamte Oberfläche einer geography-Instanz zurück. Die Ergebnisse für STArea() sind die quadratische Maßeinheit, die von der räumlichen Referenz-ID der Instanz geography verwendet wird. Wenn beispielsweise die SRID der Instanz 4326 ist, gibt STArea() die Ergebnisse in Quadratmetern zurück.

Syntax

  
.STArea ( )  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Rückgabetypen

SQL Server-Rückgabetyp: float

CLR-Rückgabetyp: SqlDouble

Hinweise

STArea() gibt 0 zurück, wenn eine geography-Instanz nur null- und eindimensionale Abbildungen enthält oder leer ist.

Hinweis

Methoden für den geography-Datentyp, die einen metrischen Rückgabewert erzeugen, liefern unterschiedliche Ergebnisse, abhängig vom SRID der in der jeweiligen Methode verwendeten Instanz. Weitere Informationen zu SRIDs finden Sie unter SRIDs (Spatial Reference Identifiers).

Beispiele

Im folgenden Beispiel wird mithilfe von STArea() eine Polygon geography-Instanz erstellt und dann der Bereich des Polygons berechnet.

DECLARE @g geography;  
SET @g = geography::STGeomFromText('POLYGON((-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))', 4326);  
SELECT @g.STArea();  

Weitere Informationen

OGC-Methoden für geography-Instanzen