名前

ST_Point — X, Y と SRID の値からポイントを生成します。

概要

geometry ST_Point(float x, float y);

geometry ST_Point(float x, float y, integer srid=unknown);

説明

与えられた X と Y の座標値からポイントを返します。これは、X と Y を取る SQL-MM のST_MakePointと同等です。

[注記]

地理座標系について、Xは経度で、Yは緯度です。

Enhanced: 3.2.0 SRID 任意引数が追加されました。古いバージョンでは、ジオメトリーに SRID を与えるには ST_SetSRID を併用しなければなりませんでした。

このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.2

ジオメトリー。

コード
SELECT ST_Point(-71.104, 42.315);

指定した SRID を持つポイントの生成:

コード
SELECT ST_Point(-71.104, 42.315, 4326);

SRID を指定する別の方法:

コード
SELECT ST_SetSRID(ST_Point(-71.104, 42.315), 4326);

ジオグラフィのポイントを、キャストの書き方 :: を使って生成します:

コード
SELECT ST_Point(-71.104, 42.315, 4326)::geography;

PostGIS 3.2より前のコードではCASTを使います:

コード
SELECT CAST(ST_SetSRID(ST_Point(-71.104, 42.315), 4326) AS geography);

ポイントの座標が地理座標系 (WGS84等) でない場合には、ジオグラフィにキャストする前に座標系変換を行う必要があります。この例では、ペンシルバニア州平面フィート (SRID 2273) 上のポイントを WGS84 (SRID 4326) に座標系変換を行っています。

コード
SELECT ST_Transform(ST_Point(3637510, 3014852, 2273), 4326)::geography;