ST_InverseTransformPipeline
上一頁  7.7. 空間參考系統函數  下一頁

名稱

ST_InverseTransformPipeline — 使用已定義的座標轉換管線的反向操作，傳回一個將座標轉換到不同空間參考系統的新幾何圖形。

概要

geometry ST_InverseTransformPipeline(geometry geom, text pipeline, integer to_srid);

描述

使用已定義的座標轉換管線，以反向方向將座標轉換到不同的空間參考系統，並傳回一個新的幾何圖形。

有關編寫轉換管線的詳細資訊，請參閱ST_TransformPipeline。

可用性：3.4.0

輸入幾何圖形的 SRID 會被忽略，除非透過選用的 to_srid 參數提供值，否則輸出幾何圖形的 SRID 將設定為零。當使用ST_TransformPipeline時，管線會以正向方向執行。使用 `ST_InverseTransformPipeline()` 時，管線會以反向方向執行。

使用管線進行轉換是 ST_Transform 的特殊版本。在大多數情況下，`ST_Transform` 會選擇正確的操作來轉換座標系統，應該優先使用。

範例

使用 EPSG:16031 轉換將 WGS 84 經緯度變更為 UTM 31N

-- Inverse direction
SELECT ST_AsText(ST_InverseTransformPipeline('POINT(426857.9877165967 5427937.523342293)'::geometry,
  'urn:ogc:def:coordinateOperation:EPSG::16031')) AS wgs_geom;

          wgs_geom
----------------------------
 POINT(2 48.99999999999999)
(1 row)

GDA2020 範例。

-- using ST_Transform with automatic selection of a conversion pipeline.
SELECT ST_AsText(ST_Transform('SRID=4939;POINT(143.0 -37.0)'::geometry, 7844)) AS gda2020_auto;

                 gda2020_auto
-----------------------------------------------
 POINT(143.00000635638918 -36.999986706128176)
(1 row)