st_touches Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna "true" se os dois valores de entrada GEOMETRY tocarem-se.

Syntax

st_touches ( geo1, geo2 )

Arguments

• geo1: Valor primeiro de GEOMETRY.
• geo2: o segundo valor GEOMETRY.

Returns

Um valor de tipo BOOLEAN, indicando se os dois valores de entrada GEOMETRY se tocam.

A função não dá suporte a coleções de geometria.

Para obter mais detalhes e a definição formal, consulte o predicado Toques na definição de matriz DE-9IM.

A função retornará NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se qualquer uma das geometrias de entrada for uma coleção de geometria, a função retornará ST_INVALID_ARGUMENT. INVALID_TYPE.
• Se as geometrias de entrada não tiverem o mesmo valor SRID, a função retornará ST_DIFFERENT_SRID_VALUES.

Examples

-- 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

Funções relacionadas

• st_contains função
• st_covers função
• st_disjoint função
• st_equals função
• st_intersects função
• st_within função