st_force2d Fonction

S’applique à : Databricks Runtime 18.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Retourne la projection 2D de l’entrée GEOGRAPHY ou GEOMETRY de la valeur.

Syntaxe

st_force2d ( geoExpr )

Arguments

• geoExpr: Une valeur GEOGRAPHY ou GEOMETRY.

Retours

Valeur de type GEOGRAPHY ou GEOMETRY, représentant la projection 2D de la valeur d’entrée.

La valeur SRID de la sortie GEOGRAPHY ou GEOMETRY est égale à celle de la valeur d’entrée.

La fonction retourne NULL si l’entrée est NULL.

Remarques

Si l’entrée a des coordonnées Z ou M, celles-ci sont exclues dans la sortie.

Si l’entrée est déjà 2D, la fonction la retourne inchangée.

Exemples

-- Drops the M coordinate from a point geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POINT M (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a multipoint geography.
> SELECT st_astext(st_force2d(st_geogfromtext('MULTIPOINT ZM (EMPTY,0 0 10 20, 1 1 11 21)')));
  MULTIPOINT(EMPTY,(0 0),(1 1))
-- Drops the Z coordinate from a polygon geography.
> SELECT st_astext(st_force2d(st_geogfromtext('POLYGON Z ((0 0 2,1 0 3,0 1 4,0 0 5))')));
  POLYGON((0 0,1 0,0 1,0 0))
-- Drops the Z coordinate from a point geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT Z (1 2 3)')));
  POINT(1 2)
-- Drops Z and M coordinates from a linestring geometry.
> SELECT st_astext(st_force2d(st_geomfromtext('LINESTRING ZM (0 0 10 20, 1 1 11 21)')));
  LINESTRING(0 0,1 1)
-- Returns the input 2D geometry as is.
> SELECT st_astext(st_force2d(st_geomfromtext('POINT(1 2)')));
  POINT(1 2)
-- Preserves the SRID of the input geography.
> SELECT st_srid(st_force2d(st_geogfromtext('POINT(1 2)')));
  4326
-- Preserves the SRID of the input geometry.
> SELECT st_srid(st_force2d(st_geomfromtext('POINT(1 2)', 4326)));
  4326
-- Returns NULL if the input is NULL.
> SELECT st_force2d(NULL);
   NULL

Fonctions associées

• Fonction st_ndims