[postgis-tickets] [SCM] PostGIS branch master updated. 3.4.0rc1-660-gf8c9d6d7b

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  f8c9d6d7b52aff966b32710f0083775ae981adf8 (commit)
      from  76f86e8f31a31aab3d847ac801fbc43369af63b2 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f8c9d6d7b52aff966b32710f0083775ae981adf8
Author: Martin Davis <mtnclimb at gmail.com>
Date:   Thu Oct 5 11:48:36 2023 -0700

    Improve doc for trajectory functions

diff --git a/doc/reference_trajectory.xml b/doc/reference_trajectory.xml
index 7770d3ca3..e5464d9f6 100644
--- a/doc/reference_trajectory.xml
+++ b/doc/reference_trajectory.xml
@@ -95,7 +95,7 @@ Returns a measure at the closest point of approach of two trajectories.
 
 			<para>
 Returns the smallest measure at which points interpolated along the given
-trajectories are at the smallest distance.
+trajectories are the least distance apart.
       </para>
 			<para>
 Inputs must be valid trajectories as
@@ -104,8 +104,7 @@ the trajectories do not overlap in their M ranges.
 			</para>
 
 			<para>
-See <xref linkend="ST_LocateAlong"/> for getting the actual points at
-the given measure.
+To obtain the actual points at the computed measure use <xref linkend="ST_LocateAlong"/> .
 			</para>
 
 			<para role="availability" conformance="2.2.0">Availability: 2.2.0</para>
@@ -129,18 +128,19 @@ WITH inp AS ( SELECT
 ), cpa AS (
   SELECT ST_ClosestPointOfApproach(a,b) m FROM inp
 ), points AS (
-  SELECT ST_Force3DZ(ST_GeometryN(ST_LocateAlong(a,m),1)) pa,
-         ST_Force3DZ(ST_GeometryN(ST_LocateAlong(b,m),1)) pb
+  SELECT ST_GeometryN(ST_LocateAlong(a,m),1) pa,
+         ST_GeometryN(ST_LocateAlong(b,m),1) pb
   FROM inp, cpa
 )
 SELECT to_timestamp(m) t,
-       ST_Distance(pa,pb) distance
+       ST_Distance(pa,pb) distance,
+       ST_AsText(pa, 2) AS pa, ST_AsText(pb, 2) AS pb
 FROM points, cpa;
 
-               t               |     distance
--------------------------------+------------------
- 2015-05-26 10:45:31.034483+02 | 1.96036833151395
-</programlisting>
+               t               |      distance      |                  pa                  |                   pb                   
+-------------------------------+--------------------+--------------------------------------+----------------------------------------
+ 2015-05-26 10:45:31.034483-07 | 1.9603683315139542 | POINT ZM (7.59 0 3.79 1432662331.03) | POINT ZM (9.1 1.24 3.93 1432662331.03)
+ </programlisting>
 		  </refsection>
 
 		  <refsection>
@@ -177,7 +177,7 @@ Returns the distance between the closest point of approach of two trajectories.
 			<title>Description</title>
 
 			<para>
-Returns the minimum distance two moving objects have ever been each other.
+Returns the distance (in 2D) between two trajectories at their closest point of approach.
       </para>
 			<para>
 Inputs must be valid trajectories as checked by

-----------------------------------------------------------------------

Summary of changes:
 doc/reference_trajectory.xml | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)


hooks/post-receive
-- 
PostGIS