ST_Dimension

ST_Dimension retorna a dimensão inerente de uma geometria de entrada. A dimensão inerente é o valor da dimensão do subtipo que está definido na geometria.

Para entradas de geometria 3DM, 3DZ e 4D, ST_Dimension retorna o mesmo resultado que para entradas de geometria 2D.

Sintaxe

ST_Dimension(geom)

Argumentos

geom

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

Tipo de retorno

INTEGER que representa a dimensão inerente de geom.

Nulo será retornado se geom for nulo.

Os valores retornados são os seguintes.

Valor retornado	Subtipo de geometria
0	Retornado se geom for um subtipo de POINT ou de MULTIPOINT.
1	Retornado se geom for um subtipo de LINESTRING ou de MULTILINESTRING.
2	Retornado se geom for um subtipo de POLYGON ou de MULTIPOLYGON.
0	Retornado se geom for um subtipo de GEOMETRYCOLLECTION vazio.
Maior dimensão dos componentes da coleção.	Retornado se geom for um subtipo GEOMETRYCOLLECTION

Exemplos

O SQL a seguir converte uma representação de texto bem-conhecido (WKT) de uma LINESTRING de quatro pontos em um objeto GEOMETRY e retorna a dimensão da linestring.

SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));

st_dimension
-------------
1