STDistance (tipo de datos geometry)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstancePunto de conexión de análisis SQL en Microsoft FabricAlmacenamiento en Microsoft Fabric

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