st_within Função

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

Retorna true se o primeiro GEOMETRY valor estiver dentro do segundo GEOMETRY valor.

Syntax

st_within ( geo1, geo2 )

Arguments

• geo1: O primeiro GEOMETRY valor.
• geo2: O segundo GEOMETRY valor.

Returns

Um valor do tipo BOOLEAN, que indica se o primeiro GEOMETRY valor está dentro do 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 Within na definição da matriz DE-9IM.

A função retorna 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