Kategorien:

Geodatenfunktionen

ST_DISTANCE

Gibt die minimale geodätische Entfernung (in Metern) zwischen zwei Geodatenobjekten zurück.

Syntax

ST_DISTANCE( <geography_expression_1> , <geography_expression_2> )

Argumente

Geografischer_Ausdruck_1

Das Argument muss ein Ausdruck vom Typ GEOGRAPHY sein.

Geografischer_Ausdruck_2

Das Argument muss ein Ausdruck vom Typ GEOGRAPHY sein.

Rückgabewerte

Gibt einen Wert vom Typ REAL zurück, der die Entfernung in Metern darstellt.

Nutzungshinweise

  • Gibt NULL zurück, wenn ein oder mehrere Eingabepunkte NULL sind.

Beispiele

Das folgende Beispiel zeigt die Entfernung in Metern zwischen zwei Punkten 1 Grad entfernt entlang des Äquators (ungefähr 111 Kilometer).

WITH d AS
    ( ST_DISTANCE(ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0)) )
SELECT d / 1000 AS kilometers, d / 1609 AS miles;
+---------------+--------------+
|    KILOMETERS |        MILES |
|---------------+--------------|
| 111.195101177 | 69.108204585 |
+---------------+--------------+

Das folgende Beispiel zeigt die Verwendung der Funktion ST_DISTANCE mit NULL-Werten:

SELECT ST_DISTANCE(ST_MAKEPOINT(0, 0), ST_MAKEPOINT(NULL, NULL));
+-----------------------------------------------------------+
| ST_DISTANCE(ST_MAKEPOINT(0, 0), ST_MAKEPOINT(NULL, NULL)) |
|-----------------------------------------------------------|
|                                                      NULL |
+-----------------------------------------------------------+