st_covers Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Retorna verdadeiro se o primeiro GEOMETRY valor cobrir o segundo GEOMETRY valor.

Syntax

st_covers ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: O primeiro GEOMETRY valor.
• geoExpr2: O segundo GEOMETRY valor.

Returns

Um valor do tipo BOOLEAN, que indica se o primeiro GEOMETRY valor abrange o segundo GEOMETRY valor.

A função não suporta coleções de geometria.

Para obter mais detalhes e a definição formal, consulte o predicado Covers na definição da 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