Available in versions: Dev (3.19) | Latest (3.18) | 3.17 | 3.16

This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.

ST_PointN

Applies to ❌ Open Source Edition   ✅ Express Edition   ✅ Professional Edition   ✅ Enterprise Edition

This function returns the Nth point (1-based) of a linestring geometry. For example:

create.select(stPointN(stGeomFromText("LINESTRING (0 0, 0 1, 1 1, 1 2)"), 2)).fetch();

The result being, for example

                        
| ST_PointN   |
+-------------+
| POINT (0 1) |
+-------------+

Or, visually:






To get the total number of points, use ST_NumPoints.

Dialect support

This example using jOOQ:

stPointN(geometry, 2)

Translates to the following dialect specific expressions:

-- AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, MARIADB, MYSQL, ORACLE, POSTGRES, REDSHIFT, SNOWFLAKE
st_pointn(geometry, 2)

-- SQLSERVER
geometry.STPointN(2)

-- ACCESS, ASE, BIGQUERY, DB2, DERBY, DUCKDB, EXASOL, FIREBIRD, H2, HANA, HSQLDB, INFORMIX, MEMSQL, SQLDATAWAREHOUSE, 
-- SQLITE, SYBASE, TERADATA, TRINO, VERTICA, YUGABYTEDB
/* UNSUPPORTED */

(These are currently generated with jOOQ 3.19, see #10141), or translate your own on our website

References to this page

Feedback

Do you have any feedback about this page? We'd love to hear it!

The jOOQ Logo