st_within Função

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

Retornará true se o primeiro GEOMETRY valor estiver dentro do segundo GEOMETRY valor.

Syntax

st_within ( geo1, geo2 )

Arguments

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

Returns

Um valor de tipo BOOLEAN, indicando se o primeiro GEOMETRY valor está dentro do 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 Dentro 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 true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false

Funções relacionadas

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