STWithin (tipo de dados de geometria)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna 1 se uma ocorrência de geometria estiver completamente dentro de outra instância de geometria ; caso contrário, retorna 0. O STWithin comando diferencia maiúsculas de minúsculas.

Syntax

  
.STWithin ( other_geometry )  

Arguments

other_geometry
É outra instância de geometria para comparar com a instância na qual STWithin() é invocada.

Tipos de devolução

Tipo de retorno do SQL Server: bit

Tipo de retorno CLR: SqlBoolean

Remarks

Esse método sempre retorna null se as IDs de referência espacial (SRIDs) das instâncias de geometria não corresponderem.

Examples

O exemplo a seguir usa STWithin() para testar duas geometry instâncias para ver se a primeira instância está completamente dentro da segunda instância.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))', 0);  
SET @h = geometry::STGeomFromText('POLYGON((1 1, 3 1, 3 3, 1 3, 1 1))', 0);  
SELECT @g.STWithin(@h);  

Ver também

Visão geral dos índices espaciais
Métodos OGC em instâncias de geometria