ST_StartPoint

定義

ST_StartPoint は、ラインストリングの最初のポイントを返します。

構文

Oracle および PostgreSQL

sde.st_startpoint (ln1 sde.st_geometry)

SQLite

st_startpoint (ln1 geometryblob)

戻り値のタイプ

ST_Point

例

テーブルの行を一意に識別する gid 列と、ln1 ST_LineString 列を持つ startpoint_test テーブルを作成します。

INSERT ステートメントは、ST_LineString を ln1 列に挿入します。最初の ST_LineString には Z 座標またはメジャー値がありませんが、2 番目の ST_LineString には両方あります。

ST_StartPoint 関数は、各 ST_LineString の最初のポイントを抽出します。ソースのラインストリングと同様に、リスト内の最初のポイントには Z 座標またはメジャー値がなく、2 番目のポイントには両方あります。

Oracle

CREATE TABLE startpoint_test (
 gid integer,
 ln1 sde.st_geometry
);

INSERT INTO STARTPOINT_TEST VALUES (
 1,
 sde.st_linefromtext ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO STARTPOINT_TEST VALUES (
 2,
 sde.st_linefromtext ('linestring zm(10.02 20.01 5 7, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);

SELECT gid, sde.st_astext (sde.st_startpoint (ln1)) Startpoint
 FROM STARTPOINT_TEST;
GID  Startpoint
1    POINT (10.02000000 20.01000000)
2    POINT ZM (10.02000000 20.01000000 5.00000000 7.00000000)

PostgreSQL

CREATE TABLE startpoint_test (
 gid serial,
 ln1 sde.st_geometry
);

INSERT INTO startpoint_test (ln1) VALUES (
 sde.st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO startpoint_test (ln1) VALUES (
 sde.st_linestring ('linestring zm(10.02 20.01 5 7, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);

SELECT gid, sde.st_astext (sde.st_startpoint (ln1)) 
 AS Startpoint
 FROM startpoint_test;
gid  startpoint
1    POINT (10.02000000 20.01000000)
2    POINT ZM (10.02000000 20.01000000 5.00000000 7.00000000)

SQLite

CREATE TABLE startpoint_test (
 gid integer primary key autoincrement not null
);
SELECT AddGeometryColumn(
 NULL,
 'startpoint_test',
 'ln1',
 4326,
 'linestringzm',
 'xyzm',
 'null'
);

INSERT INTO startpoint_test (ln1) VALUES (
 st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO startpoint_test(ln1) VALUES (
 st_linestring ('linestring zm(10.02 20.01 5 7, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);

SELECT gid, st_astext (st_startpoint (ln1)) 
 AS "Startpoint"
 FROM startpoint_test;
gid  Startpoint
1    POINT (10.02000000 20.01000000)
2    POINT ZM (10.02000000 20.01000000 5.00000000 7.00000000)