Definition
ST_StartPoint gibt den ersten Punkt eines Linestrings zurück.
Syntax
Oracle und PostgreSQL
sde.st_startpoint (ln1 sde.st_geometry)
SQLite
st_startpoint (ln1 geometryblob)
Rückgabetyp
ST_Point
Beispiele
Die Tabelle "startpoint_test" wird mit der ganzzahligen Spalte "gid", durch die die einzelnen Tabellenzeilen eindeutig gekennzeichnet werden, und der Spalte "pt1" vom Typ ST_LineString erstellt.
Mit der INSERT-Anweisung werden die ST_LineString-Werte in die Spalte "ln1" eingefügt. Der erste ST_LineString-Eintrag enthält weder Z-Koordinaten noch Messwerte, der zweite ST_LineString_Eintrag dagegen beides.
Funktion ST_StartPoint extrahiert den ersten Punkt jedes ST_LineString-Eintrags. Der Punkt in der Liste enthält weder Z-Koordinaten noch Messwerte, der zweite Punkt enthält dagegen beides, weil diese im Quell-Linestring enthalten sind.
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)