Kategorien:

Geodatenfunktionen

ST_DWITHIN

Gibt TRUE zurück, wenn der minimale Großkreisabstand zwischen zwei Punkten (zwei GEOGRAPHY-Objekten) innerhalb des angegebenen Abstands liegt. Andernfalls wird FALSE zurückgegeben.

Wenn es sich bei den Parametern um GEOGRAPHY-Werte handelt, die keine Punkte sind (z. B. Linien oder Polygone), gibt dies TRUE oder FALSE zurück, basierend auf dem minimalen Großkreisabstand zwischen den beiden nächstgelegenen Punkten der beiden Werte.

Tipp

Sie können den Suchoptimierungsdienst verwenden, um die Leistung von Abfragen zu verbessern, die diese Funktion aufrufen. Weitere Details dazu finden Sie unter Suchoptimierungsdienst.

Syntax

ST_DWITHIN( <geography_expression_1> , <geography_expression_2> , <distance_in_meters> )
Copy

Argumente

geography_expression_1

Das Argument muss ein Ausdruck vom Typ GEOGRAPHY sein.

geography_expression_2

Das Argument muss ein Ausdruck vom Typ GEOGRAPHY sein.

distance_in_meters

Das Argument muss ein Ausdruck vom Typ REAL sein. Die Entfernung wird in Meter angegeben.

Rückgabewerte

Gibt einen BOOLEAN-Wert zurück.

Nutzungshinweise

  • Gibt NULL zurück, wenn eine Eingabe NULL ist.

Beispiele

Das folgende Beispiel gibt TRUE zurück, da der Abstand in Metern zwischen zwei Punkten 1 Grad entfernt entlang des Äquators weniger als 150.000 Meter ist:

SELECT ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000);
+-------------------------------------------------------------+
| ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000) |
|-------------------------------------------------------------|
| True                                                        |
+-------------------------------------------------------------+
Copy