st_dwithin-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt true zurück, wenn der 2D Cartesian-Abstand zwischen den beiden Eingabewerten GEOMETRY kleiner oder gleich dem Eingabeabstandswert ist.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: Der erste GEOMETRY Wert.
• geoExpr2: Der zweite GEOMETRY Wert.
• distanceExpr: Der Schwellenwert für den Abstand.

Returns

Ein Wert vom Typ BOOLEAN, der angibt, ob der Abstand der beiden Eingabewerte GEOMETRY kleiner oder gleich dem Wert von distanceExprist.

Die Einheiten des Abstandsschwellenwerts sind die Koordinaten der Eingabegeometrien.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

• Wenn die beiden Eingabegeometrien unterschiedliche SRID-Werte aufweisen, gibt die Funktion ST_DIFFERENT_SRID_VALUES zurück.

Examples

-- Returns true as the distance between the point and linestring is within the threshold.
> SELECT st_dwithin(st_geomfromtext('POINT Z (0 0 300)'),st_geomfromtext('LINESTRING(-10 10,20 10)'), 10.0);
  true
-- Returns false as the distance between the geometries exceeds the threshold.
> SELECT st_dwithin(st_geomfromtext('POINT(0 0)'),st_geomfromtext('POINT(20 20)'), 10.0);
  false

Zugehörige Funktionen

• st_distance Funktion