ST_Contains - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

ST_Contains

ST_Contains retornará true se a primeira geometria de entrada contiver a segunda geometria de entrada. A geometria A conterá a geometria B se todos os pontos em B forem um ponto em A e seus interiores tiverem interseção não vazia.

ST_Contains(A, B) é equivalente a ST_Within(B, A).

Sintaxe

ST_Contains(geom1, geom2)

Argumentos

geom1

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

geom2

Um valor de tipo de dados GEOMETRY ou uma expressão que é avaliada como um tipo GEOMETRY. Esse valor é comparado com geom1 para determinar se ele está contido no geom1.

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 contém o segundo polígono. 

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

st_contains
-----------
 false