ST_EndPoint

Definition

ST_EndPoint returns the last point of a linestring.

Syntax

Oracle and PostgreSQL

sde.st_endpoint (line1 sde.st_geometry)

SQLite

st_endpoint (line1 geometryblob)

Return type

ST_Point

Example

The endpoint_test table stores the gid integer column, which uniquely identifies each row, and the ln1 ST_LineString column, which stores linestrings.

The INSERT statements insert linestrings into the endpoint_test table. The first linestring doesn't have z-coordinates or measures, while the second one does.

The query lists the gid column and the ST_Point geometry generated by the ST_EndPoint function.

Oracle

--Create table and insert values.
CREATE TABLE endpoint_test (
 gid integer,
 ln1 sde.st_geometry
);

INSERT INTO ENDPOINT_TEST VALUES (
 1,
 sde.st_linefromtext ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);

INSERT INTO ENDPOINT_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)
);

--Find the end point of each line.
SELECT gid, sde.st_astext (sde.st_endpoint (ln1)) Endpoint
 FROM ENDPOINT_TEST;

GID         Endpoint                       

 1    POINT (30.10 40.23)
 2    POINT ZM (30.10 40.23 6.9 7.2)

PostgreSQL

--Create table and insert values.
CREATE TABLE endpoint_test (
 gid integer,
 ln1 sde.st_geometry
);

INSERT INTO endpoint_test VALUES (
 1,
st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);

INSERT INTO endpoint_test VALUES (
 2,
 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)
);

--Find the end point of each line.
SELECT gid, st_astext (st_endpoint (ln1)) 
 AS endpoint
 FROM endpoint_test;

gid          endpoint                       

 1    POINT (30.10 40.23)
 2    POINT ZM (30.10 40.23 6.9 7.2)

SQLite

--Create table, add geometry column, and insert values.
CREATE TABLE endpoint_test (
 gid integer primary key autoincrement not null
);

SELECT AddGeometryColumn (
 NULL,
 'endpoint_test',
 'ln1',
 4326,
 'linestringzm',
 'xyzm',
 'null'
);

INSERT INTO endpoint_test (ln1) VALUES (
 st_linestring ('linestring (10.02 20.01, 23.73 21.92, 30.10 40.23)', 4326)
);

INSERT INTO endpoint_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)
);

--Find the end point of each line.
SELECT gid, st_astext (st_endpoint (ln1)) 
 AS "endpoint"
 FROM endpoint_test;

gid          endpoint                       

 1    POINT (30.10000000 40.23000000)
 2    POINT ZM (30.10000000 40.23000000 6.90000000 7.20000000)