ShortestLineTo (tipo de datos Geography)
Se aplica a: SQL Server
Azure SQL Database
Azure SQL Instancia administrada
Devuelve una instancia de LineString con dos puntos que representan la distancia más corta entre las dos instancias de geography. La longitud de la instancia de LineString devuelta es la distancia entre las dos instancias de geography.
Sintaxis
.ShortestLineTo ( geography_other )
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
otra_geografía
Especifica la segunda instancia de geography a la que la instancia de geography que realiza la llamada está intentando determinar la distancia más corta.
Tipos de valor devuelto
Tipo de valor devuelto de SQL Server: geography
Tipo de valor devuelto de CLR: SqlGeography
Observaciones
El método devuelve una instancia de LineString con los extremos en los bordes de las dos instancias de geography que no se cruzan y que se comparan. La longitud de la instancia de LineString devuelta es igual a la distancia más corta entre las dos instancias de geography. Se devuelve una instancia vacía de LineString cuando las dos instancias de geography se cruzan.
Ejemplos
A. Llamar a ShortestLineTo() en las instancias que no se cruzan
En este ejemplo se busca la distancia más corta entre una instancia de CircularString
y una instancia de LineString
, y se devuelven las instancias de LineString
que conectan los dos extremos:
DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';
DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.200928 47.454094)';
SELECT @g1.ShortestLineTo(@g2).ToString();
B. Llamar a ShortestLineTo() en las instancias que se cruzan
En este ejemplo se devuelve una instancia de LineString
vacía porque la instancia de LineString
se cruza con la instancia de CircularString
:
DECLARE @g1 geography = 'CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653)';
DECLARE @g2 geography = 'LINESTRING(-119.119263 46.183634, -119.273071 47.107523, -120.640869 47.569114, -122.348 47.649, -122.681 47.655)';
SELECT @g1.ShortestLineTo(@g2).ToString();
Consulte también
Métodos extendidos en instancias de geography
ShortestLineTo (tipo de datos geometry)
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios