st_force2d-Funktion

Gilt für: Databricks Runtime 18.1 und höher

Von Bedeutung

Dieses Feature befindet sich in der Public Preview.

Gibt die 2D-Projektion der Eingabe GEOGRAPHY oder GEOMETRY des Werts zurück.

Syntax

st_force2d ( geoExpr )

Argumente

• geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert.

Rückkehr

Ein Wert vom Typ GEOGRAPHY oder GEOMETRY, der die 2D-Projektion des Eingabewerts darstellt.

Der SRID-Wert des Ausgabe-GEOGRAPHY- oder GEOMETRY-Werts entspricht dem des Eingabewerts.

Die Funktion gibt zurück NULL , wenn die Eingabe lautet NULL.

Hinweise

Wenn die Eingabe Z- oder M-Koordinaten aufweist, werden diese in der Ausgabe ausgeschlossen.

Wenn die Eingabe bereits 2D ist, gibt die Funktion sie unverändert zurück.

Beispiele

-- 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

Verwandte Funktionen

• st_ndims Funktion