st_makepoint Funkce

Platí pro:check marked yes Databricks SQL check marked yes Databricks Runtime 18.2 and above

Note

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Vrátí hodnotu bodu GEOMETRY s danými souřadnicemi. Funkce přebírá 2, 3 nebo 4 DOUBLE hodnoty představující souřadnice bodu (x, y, z) nebo (x, y, z, m).

Syntax

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

Argumenty

  • x DOUBLE: Hodnota představující první souřadnici bodu.
  • y: Hodnota DOUBLE představující druhou souřadnici bodu.
  • z: Volitelná DOUBLE hodnota představující třetí souřadnici bodu (Z).
  • m: Volitelná DOUBLE hodnota představující čtvrtou souřadnici bodu (M).

Returns

Hodnota typu GEOMETRYpředstavující bod se zadanými souřadnicemi.

Hodnota SRID vrácené geometrie je vždy 0.

Počet vstupních souřadnic určuje rozměr vráceného bodu: 2D, pokud zadáte pouze x a y, 3DZ pokud zadáte také z, nebo 4D, pokud zadáte všechny čtyři souřadnice (x, y, za m).

Funkce vrátí NULL , pokud je některý ze vstupů NULL.

Příklady

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