ST_CoveredBy

ST_CoveredBy retorna true se a projeção 2D da primeira geometria de entrada for coberta pela projeção 2D da segunda geometria de entrada. A geometria A será coberta pela geometria B se ambas não estiverem vazias e todos os pontos em A forem um ponto em B.

ST_CoveredBy(A, B) é equivalente a ST_Covers(B, A).

Sintaxe

ST_CoveredBy(geom1, geom2)

Argumentos

geom1

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. Esse valor é comparado com geom2 para determinar se ele é coberto por geom2.

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY.

Tipo de retorno

BOOLEAN

Nulo será retornado se geom1 ou geom2 for nulo.

Um erro será retornado se geom1 e geom2 não tiverem o mesmo valor do identificador do sistema referência espacial (SRID -spatial reference system identifier).

Um erro será retornado se geom1 ou geom2 for uma coleção de geometrias.

Exemplos

O SQL a seguir verifica se o primeiro polígono é coberto pelo segundo polígono.

SELECT ST_CoveredBy(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));

st_coveredby
-----------
 true