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();