st_covers Função

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

Retorna true se o primeiro GEOMETRY valor abrange o segundo GEOMETRY valor.

Syntax

st_covers ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: Valor primeiro de GEOMETRY.
• geoExpr2: o segundo valor GEOMETRY.

Returns

Um valor de tipo BOOLEAN, indicando se o primeiro GEOMETRY valor abrange o segundo GEOMETRY valor.

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

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

Condições de erro

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

Examples

> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(1 1)'));
  true

> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 0)'));
  true

> SELECT st_covers(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 6)'));
  false

Funções relacionadas

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