STGeomFromText (geography data type)
Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance
Returns a geography instance from an Open Geospatial Consortium (OGC) Well-Known Text (WKT) representation augmented with any Z (elevation) and M (measure) values carried by the instance.
This geography data type method supports FullGlobe
instances or spatial instances that are larger than a hemisphere.
Syntax
STGeomFromText ( 'geography_tagged_text' , SRID )
Arguments
geography_tagged_text
The WKT representation of the geography instance to return. geography_tagged_text is nvarchar(max).
SRID
An int expression representing the spatial reference ID (SRID) of the geography instance to return.
Return types
- SQL Server return type: geography
- CLR return type:
SqlGeography
Remarks
The OGC type of the geography instance returned by STGeomFromText()
is set to the corresponding WKT input.
This method throws an ArgumentException
if the input contains an antipodal edge.
Note
The order in which the points are listed matters for geography polygons. It determines if the polygon area is to the inside or outside of the given ring. For more information, see Polygon.
Examples
The following example uses STGeomFromText()
to create a geography instance.
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();