Name

ST_EndPoint — Renvoie le dernier point d'une LineString ou CircularLineString.

Synopsis

geometry ST_EndPoint(geometry g);

Description

Renvoie le dernier point d'une géométrie LINESTRING ou CIRCULARLINESTRING comme un POINT. Renvoie NULL si l'entrée n'est pas une LINESTRING ou CIRCULARLINESTRING.

Cette méthode implémente la spécification SQL/MM.

SQL-MM 3 : 7.1.4

Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

Cette méthode prend en charge les types Circular String et Curve.

[Note]

Modifié : 2.0.0 ne fonctionne plus avec les MultiLineStrings à géométrie unique. Dans les anciennes versions de PostGIS, une MultiLineString à géométrie unique fonctionnait avec cette fonction et renvoyait le point final. Dans la version 2.0.0, elle renvoie NULL comme toute autre MultiLineString. L'ancien comportement était une fonctionnalité non documentée, mais les personnes qui supposaient que leurs données étaient stockées en tant que LINESTRING peuvent voir ces dernières retourner NULL dans la version 2.0.0.

Exemples

Point final d'une ligne

postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::geometry));
 st_astext
------------
 POINT(3 3)

Le point final d'une ligne qui n'en est pas une est NULL

SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;
  is_null
----------
 t

Point final d'une ligne 3D

--3d endpoint
SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
  st_asewkt
--------------
 POINT(0 0 5)

Point d'arrivée d'une CircularString

SELECT ST_AsText(ST_EndPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
 st_astext
------------
 POINT(6 3)

Voir aussi

ST_PointN, ST_StartPoint