Kategorien:: Geodatenfunktionen

ST_DWITHIN¶

Returns TRUE if the minimum geodesic distance between two points (two GEOGRAPHY objects) is within the specified distance. Otherwise, returns FALSE.

Wenn die Parameter GEOGRAPHY-Werte sind, die keine Punkte sind (z. B. Linien oder Polygone), wird TRUE oder FALSE zurückgegeben, auf Basis des minimalen geodätischen Abstands zwischen den beiden nächstgelegenen Punkten der beiden Werte.

Syntax¶

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

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                                                        |
+-------------------------------------------------------------+