Definition
ST_PointN akzeptiert ein ST_LineString-Objekt und einen ganzzahligen Index und gibt den Punkt zurück, der den n-ten Stützpunkt im Pfad des ST_LineString-Objekts darstellt.
Syntax
Oracle und PostgreSQL
sde.st_pointn (line1 sde.st_linestring, index integer)
SQLite
st_pointn (line1 st_linestring, index int32)
Rückgabetyp
ST_Point
Beispiel
Die Tabelle "pointn_test" wird mit der Spalte "gid", durch die die einzelnen Zeilen eindeutig gekennzeichnet werden, und der Spalte "pt1" vom Typ ST_LineString erstellt. Mit der INSERT-Anweisung werden zwei Linestring-Werte in die Tabelle eingefügt. Der erste Linestring enthält weder Z-Koordinaten noch Messwerte, der zweite Linestring dagegen beides.
Die SELECT-Abfrage verwendet die Funktionen "ST_PointN" und "ST_AsText", um den Well-Known Text für den zweiten Stützpunkt jedes Linestrings zurückzugeben.
Oracle
CREATE TABLE pointn_test (
gid integer,
ln1 sde.st_geometry
);
INSERT INTO POINTN_TEST VALUES (
1,
sde.st_linefromtext ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO POINTN_TEST VALUES (
2,
sde.st_linefromtext ('linestring zm(10.02 20.01 5.0 7.0, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);
SELECT gid, sde.st_astext (sde.st_pointn (ln1, 2)) The_2ndvertex
FROM POINTN_TEST;
GID The_2ndvertex
1 POINT (23.73 21.92)
2 POINT ZM (23.73 21.92 6.5 7.1)
PostgreSQL
CREATE TABLE pointn_test (
gid serial,
ln1 sde.st_geometry
);
INSERT INTO pointn_test (ln1) VALUES (
sde.st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO pointn_test (ln1) VALUES (
sde.st_linestring ('linestring zm(10.02 20.01 5.0 7.0, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);
SELECT gid, sde.st_astext (sde.st_pointn (ln1, 2))
AS The_2ndvertex
FROM pointn_test;
gid the_2ndvertex
1 POINT (23.73 21.92)
2 POINT ZM (23.73 21.92 6.5 7.1)
SQLite
CREATE TABLE pointn_test (
gid integer primary key autoincrement not null
);
SELECT AddGeometryColumn(
NULL,
'pointn_test',
'ln1',
4326,
'linestringzm',
'xyzm',
'null'
);
INSERT INTO pointn_test (ln1) VALUES (
st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);
INSERT INTO pointn_test (ln1) VALUES (
st_linestring ('linestring zm(10.02 20.01 5.0 7.0, 23.73 21.92 6.5 7.1, 30.10 40.23 6.9 7.2)', 4326)
);
SELECT gid, st_astext (st_pointn (ln1, 2))
AS "Second Vertex"
FROM pointn_test;
gid Second Vertex
1 POINT ( 23.73000000 21.92000000)
2 POINT ZM ( 23.73000000 21.92000000 6.50000000 7.10000000)