Freigeben über

STGeomFromText (Geografischer Datentyp)

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz

Gibt eine geography-Instanz einer Open Geospatial Consortium (OGC) WKT-Darstellung (Well-Known Text) zurück, die um alle von der Instanz getragenen Z (Höhe)- und M (Measure)-Werte erweitert ist.

Diese Methode des Geografischen Datentyps unterstützt FullGlobe Instanzen oder räumliche Instanzen, die größer als eine Hemisphäre sind.

Syntax

STGeomFromText ( 'geography_tagged_text' , SRID )

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.

Argumente

geography_tagged_text

Die WKT-Darstellung der zurückzugebenden geografischen Instanz. geography_tagged_text ist nvarchar(max).

SRID

Ein Int-Ausdruck , der die räumliche Bezugs-ID (SRID) der zurückzugebenden geografischen Instanz darstellt.

Rückgabetypen

  • SQL Server-Rückgabetyp: geography
  • CLR-Rückgabetyp: SqlGeography

Hinweise

Der OGC-Typ der geography -Instanz, die von STGeomFromText() zurückgegeben wird, wird auf die entsprechende WKT-Eingabe festgelegt.

Diese Methode löst ein ArgumentException , wenn die Eingabe einen antipodalen Rand enthält.

Hinweis

Die Reihenfolge, in der die Punkte aufgeführt sind, ist wichtig für geografische Polygone. Dadurch wird bestimmt, ob sich der Polygonbereich innerhalb oder außerhalb des angegebenen Rings befindet. Weitere Informationen finden Sie unter Polygon.

Beispiele

Im folgenden Beispiel wird STGeomFromText() eine Geografieinstanz erstellt.

DECLARE @g geography;
-- Starting point: Lat. 47.656, Lon. -122.360
-- Ending point: Lat. 47.656, Lon. -122.343
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.ToString();

Zugehöriger Inhalt