st_makepoint функция

Область применения:check помечена да Databricks Runtime 18.2 и выше

Important

Эта функция доступна в общедоступной предварительной версии.

Возвращает значение точки GEOMETRY с заданными координатами. Функция принимает 2, 3 или 4 DOUBLE значения, представляющие координаты точки (x, y), (x, y, z) или (x, y, z, m).

Syntax

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

Arguments

  • x DOUBLE: значение, представляющее первую координату точки.
  • y DOUBLE: значение, представляющее вторую координату точки.
  • z: необязательное DOUBLE значение, представляющее третью координату (Z) точки.
  • m: необязательное DOUBLE значение, представляющее четвертую (M) координату точки.

Returns

Значение типа GEOMETRY, представляющее точку с указанными координатами.

Значение SRID возвращаемой геометрии всегда 0.

Число входных координат определяет измерение возвращаемой точки: 2D, если вы предоставляете только x и y3DZ, если вы также предоставляете zили 4D, если вы предоставляете все четыре координаты (x, y, zи ).m

Функция возвращает NULL, если какие-либо из входных данных NULL.

Примеры

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