st_dwithin Funkce

Platí pro: Kontrola SQL Databricks Databricks Runtime 17.1 a vyšší

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Vrátí hodnotu true, pokud je 2D kartézská vzdálenost mezi těmito dvěma vstupními GEOMETRY hodnotami menší nebo rovna vstupní hodnotě vzdálenosti.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: První GEOMETRY hodnota.
• geoExpr2: Druhá GEOMETRY hodnota.
• distanceExpr: Hodnota prahové hodnoty vzdálenosti.

Returns

Hodnota typu BOOLEANoznačující, zda je vzdálenost dvou vstupních GEOMETRY hodnot menší nebo rovna hodnotě distanceExpr.

Jednotky prahové hodnoty vzdálenosti jsou souřadnice vstupních geometrií.

Funkce vrátí NULL , pokud je některý ze vstupů NULL.

Chybové podmínky

• Pokud mají dvě vstupní geometrie různé hodnoty SRID, vrátí funkce 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

Související funkce

• st_closestpoint funkce
• st_distance funkce