STContains (geography Data Type)

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance

Specifies whether the calling geography instance spatially contains the geography instance passed to the method.

Syntax

  
.STContains ( other_geography )  

Note

To view Transact-SQL syntax for SQL Server 2014 (12.x) and earlier versions, see Previous versions documentation.

Arguments

other_geography
Is another geography instance to compare against the instance on which STContains() is invoked.

Return Types

SQL Server return type: bit

CLR return type: SqlBoolean

Remarks

Returns 1 if the calling geography instance spatially contains the geography instance passed to the method, and returns 0 if it does not. Returns null if the SRID of the two geography instances are not the same.

Examples

The following example uses STContains() to test two geography instances to see if the first instance contains the second instance.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::Parse('CURVEPOLYGON (COMPOUNDCURVE (CIRCULARSTRING (-122.200928 47.454094, -122.810669 47.00648, -122.942505 46.687131, -121.14624 45.786679, -119.119263 46.183634), (-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.200928 47.454094)))');  
SET @h = geography::Parse('POINT(-121.703796 46.893985)');  

SELECT @g.STContains(@h);