STGeometryN (geography Data Type)

STGeometryN (geography Data Type)


Applies To: SQL Server 2014, SQL Server 2016 Preview

Returns a specified geography element in a GeometryCollection or one of its subtypes. When STGeometryN() is used on a subtype of a GeometryCollection, such as MultiPoint or MultiLineString, this method returns the geography instance if called with N=1. 

Applies to: SQL Server (SQL Server 2008 through current version), Azure SQL Database.

.STGeometryN ( expression )


Is an int expression between 1 and the number of geography instances in the GeometryCollection.

SQL Server return type: geography

CLR return type: SqlGeography

This method returns null if the parameter is larger than the result of STNumGeometries() and will throw an ArgumentOutOfRangeException if the expression parameter is less than 1.

The following example creates a MultiPoint geography instance and uses STGeometryN() to find the second geography instance of the GeometryCollection.

DECLARE @g geography;
SET @g = geography::STGeomFromText('MULTIPOINT(-122.360 47.656, -122.343 47.656)', 4326);
SELECT @g.STGeometryN(2).ToString();

Community Additions

© 2015 Microsoft