funktion st_dwithin

Gäller för: Databricks Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Returnerar sant om det 2D-kartesiska avståndet mellan de två indatavärdena GEOMETRY är mindre än eller lika med indataavståndsvärdet.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: Det första GEOMETRY värdet.
• geoExpr2: Det andra GEOMETRY värdet.
• distanceExpr: Tröskelvärdet för avstånd.

Returns

Ett värde av typen BOOLEAN, som anger om avståndet för de två indatavärdena GEOMETRY är mindre eller lika med värdet för distanceExpr.

Avståndströskelenheterna är koordinaterna för indatageometrierna.

Funktionen returnerar NULL om någon av indata är NULL.

Feltillstånd

• Om de två indatageometrierna har olika SRID-värden returnerar funktionen ST_DIFFERENT_SRID_VALUES.

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

Relaterade funktioner

• st_distance funktion