ST_Force3DZ

PDFRSS

ST_Force3DZ retorna uma geometria 3DZ da geometria de entrada. Para geometrias 2D, as coordenadas z dos pontos não vazios na geometria de saída são todas definidas como 0. Para geometrias 3DM, a geometria é projetada no plano XY cartesiano, e as coordenadas z dos pontos não vazios na geometria de saída são todas definidas como 0. Para geometrias 3DZ, uma cópia da geometria de entrada será retornado. Para geometrias 4D, a geometria é projetada para o espaço XYZ-cartesiano. Pontos vazios na geometria de entrada permanecem pontos vazios na geometria de saída.

Sintaxe

ST_Force3DZ(geom)

Argumentos

geom

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

Tipo de retorno

GEOMETRY.

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada.

Nulo será retornado se geom for nulo.

Se geom estiver vazio, será retornado uma geometria vazia.

Exemplos

O SQL a seguir retorna uma geometria 3DZ de uma geometria 3DM.

SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromText('MULTIPOINT M(0 1 2, EMPTY, 2 3 4, 5 6 7)')));

st_asewkt
-----------
  MULTIPOINT Z ((0 1 0),EMPTY,(2 3 0),(5 6 0))