Delen via


STDistance (geografiegegevenstype)

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Retourneert de kortste afstand tussen een punt in een geografisch exemplaar en een punt in een ander geografisch exemplaar.

Note

STDistance() retourneert de kortste LineString tussen twee geografietypen. Dit is een dicht bij benadering van de geodetische afstand. De afwijking van STDistance() algemene aardmodellen van de exacte geodetische afstand is niet meer dan 0,25%. Dit voorkomt verwarring over de subtiele verschillen tussen lengte en afstand in geodetische typen.

Syntax

  
.STDistance ( other_geography )  

Arguments

other_geography
Is een ander geografisch exemplaar waaruit de afstand wordt gemeten tussen het exemplaar waarop STDistance() wordt aangeroepen. Als other_geography een lege set is, retourneert STDistance() null.

Retourtypen

Retourtype SQL Server: float-

CLR-retourtype: SqlDouble-

Remarks

Het resultaat wordt uitgedrukt in de maateenheid die is gedefinieerd door de Spatial Reference Identifier (SRID) van ruimtelijke gegevens. STDistance() retourneert altijd null als de ruimtelijke referentie-id's (SRID's) van de geografische instanties niet overeenkomen.

Note

Methoden voor het geografiegegevenstype waarmee een gebied of afstand wordt berekend, retourneren verschillende resultaten op basis van de SRID van het exemplaar dat in de methode wordt gebruikt. Zie Spatial Reference Identifiers (SRID's) voor meer informatie over SRID's.

Examples

In het volgende voorbeeld wordt de afstand tussen twee geografische instanties gevonden.

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);  

Zie ook

OGC-methoden voor geografieexemplaren