Funzione st_dwithin

Si applica a: controllo SQL di Databricks Databricks Runtime 17.1 e versioni successive

Important

Questa funzionalità è in Anteprima Pubblica.

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Restituisce true se la distanza cartesiana 2D tra i due valori di input GEOMETRY è minore o uguale al valore della distanza di input.

Syntax

st_dwithin ( geoExpr1, geoExpr2, distanceExpr )

Arguments

• geoExpr1: il primo GEOMETRY valore.
• geoExpr2: il secondo valore GEOMETRY.
• distanceExpr: valore soglia distanza.

Returns

Valore di tipo BOOLEAN, che indica se la distanza dei due valori di input GEOMETRY è minore o uguale al valore di distanceExpr.

Le unità della soglia di distanza sono quelle delle coordinate delle geometrie di input.

La funzione restituisce NULL se uno degli input è NULL.

Condizioni di errore

• Se le due geometrie di input hanno valori SRID diversi, la funzione restituisce 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

Funzioni correlate

• st_distance Funzione