STDistance (zeměpisný datový typ)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Vrátí nejkratší vzdálenost mezi bodem v instanci zeměpisu a bodem v jiné geografické instanci.

Note

STDistance() vrátí nejkratší linestring mezi dvěma zeměpisnými typy. Jedná se o blízkost geodesické vzdálenosti. Odchylka STDistance() běžných modelů země od přesné geodesické vzdálenosti není větší než 0,25%. Tím se vyhnete nejasnostem v drobných rozdílech mezi délkou a vzdáleností v geodesických typech.

Syntax

  
.STDistance ( other_geography )  

Arguments

other_geography
Je další geografická instance, ze které se měří vzdálenost mezi instancí, na které je vyvolána funkce STDistance(). Pokud other_geography je prázdná sada, vrátí funkce STDistance() hodnotu null.

Návratové typy

Návratový typ SQL Serveru: plovoucí

Návratový typ CLR: sqlDouble

Remarks

Výsledek se vyjadřuje v jednotce měření definované identifikátorem prostorových dat (SRID) prostorových dat. Funkce STDistance() vždy vrátí hodnotu null , pokud id prostorového odkazu (SRID) geografických instancí neodpovídají.

Note

Metody pro datový typ zeměpisu , které vypočítají oblast nebo vzdálenost, vrátí různé výsledky na základě SRID instance použité v metodě. Další informace o identifikátorech SRID najdete v tématu Identifikátory prostorových odkazů (SRID).

Examples

Následující příklad najde vzdálenost mezi dvěma zeměpisnými instancemi.

DECLARE @g geography;  
DECLARE @h geography;  
SET @g = geography::STGeomFromText('LINESTRING(-122.360 47.656, -122.343 47.656)', 4326);  
SET @h = geography::STGeomFromText('POINT(-122.34900 47.65100)', 4326);  
SELECT @g.STDistance(@h);  

Viz také

Metody OGC v geografických instancích