次の方法で共有


st_transform 関数

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

Important

この機能は パブリック プレビュー段階です

入力ジオメトリの X 座標と Y 座標を、現在の座標参照システム (CRS) から、指定された SRID 値によって記述された座標参照システムに変換します。

Syntax

st_transform ( geo, srid )

Arguments

  • geo: GEOMETRY 値。
  • srid: 入力ジオメトリの変換先となる新しい座標参照システム (CRS) の SRID 値。

Returns

変換されたジオメトリを表す GEOMETRY型の値。

ジオメトリに Z 座標と M 座標がある場合、それらは出力ジオメトリに存在し、変更されません。

出力 GEOMETRY の SRID は、入力 SRID 値と等しくなります。

いずれかの入力がNULLされている場合、関数はNULLを返します。

Error conditions

  • 入力 SRID 値が正でない場合、関数は ST_INVALID_ARGUMENTを返します。
  • 入力ジオメトリの CRS から指定された SRID 値によって記述された CRS に変換できない場合、関数は ST_INVALID_ARGUMENT返します。

Examples

-- Transforms coordinates from WGS84 to Web Mercator.
> SELECT st_astext(st_transform(st_geomfromtext('MULTIPOINT Z (4 5 14,-3 8 27,EMPTY)', 4326), 3857))
  MULTIPOINT Z ((445277.96317309426 557305.2572745768 14),(-333958.4723798207 893463.751012646 27),EMPTY)
-- Returns geometry in new coordinate system.
> SELECT st_srid(st_transform(st_geomfromtext('POINT(0 0)', 4326), 3857))
  3857