ST_Intersection

ST_Intersection retorna uma geometria que representa a interseção do conjunto de pontos de duas geometrias. Ou seja, retorna a parte das duas geometrias de entrada que é compartilhada entre elas.

Sintaxe

ST_Intersection(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.

Tipo de retorno

GEOMETRY

Se geom1 e geom2 não compartilhar nenhum espaço (não contíguos), será retornada uma geometria vazia.

Se geom1 e geom2 estiverem vazios, será retornada uma geometria vazia.

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.

Se geom1 ou geom2 não forem uma geometria bidimensional (2D), será retornado um erro.

Exemplos

O SQL a seguir retorna a geometria não vazia que representa a interseção de duas geometrias de entrada.

SELECT ST_AsEWKT(ST_Intersection(ST_GeomFromText('polygon((0 0,100 100,0 200,0 0))'), ST_GeomFromText('polygon((0 0,10 0,0 10,0 0))')));

        st_asewkt        
-------------------------
 POLYGON((0 0,0 10,5 5,0 0))           

O SQL a seguir retorna uma geometria vazia quando passam geometrias de entrada não contíguas (sem interseção).

SELECT ST_AsEWKT(ST_Intersection(ST_GeomFromText('linestring(0 100,0 0)'), ST_GeomFromText('polygon((1 0,10 0,1 10,1 0))')));

    st_asewkt     
------------------
 LINESTRING EMPTY