st_makepoint-Funktion

Gilt für:check marked yes Databricks Runtime 18.2 und höher

Important

Dieses Feature befindet sich in der Public Preview.

Gibt einen Punktwert GEOMETRY mit den angegebenen Koordinaten zurück. Die Funktion akzeptiert 2,3 oder 4 DOUBLE Werte, die die Koordinaten (x, y), (x, y, z) oder (x, y, z, m) des Punkts darstellen.

Syntax

st_makepoint ( x, y [, z [, m ] ] )

Arguments

  • x: Ein DOUBLE Wert, der die erste Koordinate des Punkts darstellt.
  • y: Ein DOUBLE Wert, der die zweite Koordinate des Punkts darstellt.
  • z: Ein optionaler DOUBLE Wert, der die dritte (Z)-Koordinate des Punkts darstellt.
  • m: Ein optionaler DOUBLE Wert, der die vierte (M)-Koordinate des Punkts darstellt.

Rückkehr

Ein Wert vom Typ GEOMETRY, der einen Punkt mit den angegebenen Koordinaten darstellt.

Der SRID-Wert der zurückgegebenen Geometrie ist immer 0.

Die Anzahl der Eingabekoordinaten bestimmt die Dimension des zurückgegebenen Punkts: 2D, wenn Sie nur x angeben und y, 3DZ, wenn Sie auch zangeben , oder 4D, wenn Sie alle vier Koordinaten (x, y, zund m).

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Beispiele

-- Creates a 2D point with coordinates (10, 34).
> SELECT st_astext(st_makepoint(10.0, 34.0));
  POINT(10 34)
-- Creates a 3DZ point with coordinates (1, 2, 3).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0));
  POINT Z (1 2 3)
-- Creates a 4D point with coordinates (1, 2, 3, 4).
> SELECT st_astext(st_makepoint(1.0, 2.0, 3.0, 4.0));
  POINT ZM (1 2 3 4)

-- The SRID of the returned geometry is always 0.
> SELECT st_srid(st_makepoint(10.0, 34.0));
  0
-- The type of the returned geometry is always geometry(0).
> SELECT typeof(st_makepoint(10.0, 34.0));
  geometry(0)

-- The function returns NULL if any of the inputs is NULL.
> SELECT st_astext(st_makepoint(10.0, NULL));
  NULL
  • Last updated on