STWithin (tipo de dados geometry)

Aplica-se a: SQL Server (todas as versões com suporte) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

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

Sintaxe

  
.STWithin ( other_geometry )  

Observação

Para ver a sintaxe do Transact-SQL para o SQL Server 2014 e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

other_geometry
É outra instância de geometry a ser comparada com a instância na qual STWithin() é invocado.

Tipos de retorno

Tipo de retorno do SQL Server: bit

Tipo de retorno do CLR: SqlBoolean

Comentários

Esse método sempre retornará nulo se as SRIDs (IDs de referência espacial) das instâncias de geometry não forem correspondentes.

Exemplos

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

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

Consulte Também

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