st_makepoint 関数

適用対象:はい Databricks SQL チェックが Databricks Runtime 18.2 以降" とマークされているチェック

Note

この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。

指定した座標を持つポイント GEOMETRY 値を返します。 この関数は、ポイントの (x、y)、(x、y、z)、または (x、y、z、m) 座標を表す 2、3、または 4 の DOUBLE 値を受け取ります。

Syntax

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

論争

  • x: ポイントの最初の座標を表す DOUBLE 値。
  • y:ポイントの 2 番目の座標を表す DOUBLE 値。
  • z: ポイントの 3 番目の (Z) 座標を表す省略可能な DOUBLE 値。
  • m: ポイントの 4 番目の (M) 座標を表す省略可能な DOUBLE 値。

返品

指定した座標を持つ点を表す GEOMETRY型の値。

返されるジオメトリの SRID 値は常に 0。

入力座標の数によって、返されるポイントの寸法が決まります。 x と yのみを指定する場合は 2D、 zも指定した場合は 3DZ、4 つの座標 (x、 y、 z、 m) をすべて指定した場合は 4D。

いずれかの入力が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