STRelate (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 instância de geometria estiver relacionada a outra instância de geometria , onde a relação é definida por um valor de matriz de padrão DE-9IM (Dimensionally Extended 9 Intersection Model); caso contrário, retorna 0.

Syntax

  
.STRelate ( other_geometry, intersection_pattern_matrix )  

Arguments

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

intersection_pattern_matrix
É uma cadeia de caracteres do tipo nchar(9) que codifica valores aceitáveis para o dispositivo de matriz de padrão DE-9IM entre as duas instâncias de geometria .

Remarks

Esse método sempre retorna null se as IDs de referência espacial (SRIDs) das instâncias de geometria não corresponderem. Esse método lançará um ArgumentException se a matriz não estiver bem formada.

Tipos de devolução

Tipo de retorno do SQL Server: bit

Tipo de retorno CLR: SqlBoolean

Examples

O exemplo a seguir usa STRelate() para testar duas instâncias de geometria para disjunção espacial usando um padrão DE-9IM explícito.

DECLARE @g geometry;  
DECLARE @h geometry;  
SET @g = geometry::STGeomFromText('LINESTRING(0 2, 2 0, 4 2)', 0);  
SET @h = geometry::STGeomFromText('POINT(5 5)', 0);  
SELECT @g.STRelate(@h, 'FF*FF****');  

Ver também

Métodos OGC em instâncias de geometria