Name
ST_StartPoint — LINESTRING, CIRCULARSTRING, NURBSCURVE の最初のポイントを返します。
Synopsis
geometry ST_StartPoint(geometry geomA);
説明
LINESTRING, CIRCULARLINESTRING, NURBSCURVEジオメトリーの最初のポイントをPOINTで返します。他のジオメトリーを与えた場合には、座標の並び順で最初のポイントを返します。
このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.3
この関数は3次元に対応し、Z値を削除しません。
このメソッドは曲線ストリングと曲線に対応しています。
![[Note]](../images/note.png)
|
|
|
Enhanced: 3.2.0 全てのジオメトリのポイントを返すようになりました。以前のバージョンではラインストリング以外ではNULLを返していました。 Changed: 2.0.0 一つのMULTILINESTRINGで動作しなくなりました。PostGIS の古いバージョンでは、この関数は、一つのラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、始端ポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。 |
例
ラインストリングの始端ポイント
SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));
POINT(0 1)
ポイントの始端ポイントはそのポイント自体です
SELECT ST_AsText(ST_StartPoint('POINT(0 1)'::geometry));
POINT(0 1)
3次元ラインストリングの始端ポイント
SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));
POINT(0 1 1)
CIRCULARSTRINGの始端ポイント
SELECT ST_AsText(ST_StartPoint('CIRCULARSTRING(5 2,-3 2, -2 1, -4 2, 6 3)'::geometry));
POINT(5 2)
NURBSCURVEの始端ポイント
SELECT ST_AsText(ST_StartPoint('NURBSCURVE(2, (0 0, 1 1, 2 0))'::geometry));
POINT(0 0)