ST_StartPoint

Définition

ST_StartPoint retourne le premier point d'un objet linestring.

Syntaxe

Oracle et PostgreSQL

sde.st_startpoint (ln1 sde.st_geometry)

SQLite

st_startpoint (ln1 geometryblob)

Type de retour

ST_Point

Exemples

La table startpoint_test est créée avec la colonne gid integer, qui identifie de façon unique les enregistrements de la table, et la colonne ST_LineString ln1.

Les instructions INSERT insèrent ST_LineStrings dans la colonne ln1. Le premier ST_LineString ne possède pas de coordonnées z ou de mesures, alors que le deuxième ST_LineString possède les deux.

La fonction ST_StartPoint extrait le premier point de chaque ST_LineString. Le premier point de la liste ne possède pas de coordonnée z ou de mesure, alors que le deuxième point possède les deux, comme l'objet linestring source.

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)