メインコンテンツまでスキップ

st_touches function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Preview

This feature is in Public Preview.

Returns true if the two geometries touch each other.

Syntax

st_touches ( geo1, geo2 )

Arguments

  • geo1: The first GEOMETRY value.
  • geo2: The second GEOMETRY value.

Returns

A value of type BOOLEAN, true if the two geometries touch each other.

The function returns NULL if any of the inputs is NULL.

Error conditions

Examples

SQL
-- Returns false when geometries do not touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 10)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
false
-- Returns true when geometries touch.
> SELECT st_touches(st_geomfromtext('LINESTRING(5 0,5 5)'),st_geomfromtext('MULTILINESTRING((0 0,10 10),(0 10,10 0))'));
true