ST_Force3DM

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

Sintaxe

ST_Force3DM(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 3DM de uma geometria 3DZ.

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

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