STDistance (tipo de datos geometry)

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance

Devuelve la distancia más corta entre un punto de una instancia de geometry y un punto de otra instancia de geometry.

Sintaxis

  
.STDistance ( other_geometry )  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

other_geometry
Es otra instancia de geometry a partir de la que medir la distancia entre la instancia en la que se invoca a STDistance(). Si other_geometry es un conjunto vacío, STDistance() devuelve NULL.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: float

Tipo de valor devuelto de CLR: SqlDouble

Comentarios

STDistance() siempre devuelve NULL si no coinciden los identificadores de referencia espacial (SRID) de las instancias de geometry.

Ejemplos

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('POINT(10 10)', 0);  
SELECT @g.STDistance(@h);  

Consulte también

Información general sobre los índices espaciales
Métodos de OGC en instancias de geometry