PolarDB:ST_DumpPoints

Syntax

setof record ST_DumpPoints(trajectory traj);

Parameters

Return values

Returns a result set with two columns: the sequence number of each trajectory point and the trajectory point itself.

Description

ST_DumpPoints iterates over all points in a trajectory and returns each one as a separate record. Use this function to decompose a trajectory into individual point objects for per-point analysis or processing.

Example

The following example creates a trajectory from a three-point LINESTRING, then calls ST_DumpPoints to expand it into individual records. The .* syntax expands the composite record columns (id and point) into separate output columns.

WITH traj_table AS
       (
         SELECT ST_MakeTrajectory('STPOINT'::leaftype, st_geomfromtext('LINESTRING (114 35, 114 35, 116 37)', 4326), ARRAY['2010-1-11 14:30'::timestamp,'2010-1-11 14:30', '2010-1-11 15:00'], '{"leafcount":3,"attributes":{"velocity": {"type": "integer", "length": 2,"nullable" : true,"value": [120, 130, 140]}, "accuracy": {"type": "float", "length": 4, "nullable" : false,"value": [120, 130, 140]}, "bearing": {"type": "float", "length": 8, "nullable" : false,"value": [120, 130, 140]}, "acceleration": {"type": "string", "length": 20, "nullable" : true,"value": ["120", "130", "140"]}, "active": {"type": "timestamp", "nullable" : false,"value": ["Fri Jan 01 14:30:00 2010", "Fri Jan 01 15:00:00 2010", "Fri Jan 01 15:30:00 2010"]}}, "events": [{"1" : "Fri Jan 01 14:30:00 2010"}, {"2" : "Fri Jan 01 15:00:00 2010"}, {"3" : "Fri Jan 01 15:30:00 2010"}]}') traj
       )
SELECT (ST_DumpPoints(traj)).* FROM traj_table;

Sample result:

id |  point
---+-----------------------------------------------
  1 | {"trajectory":{"version":1,"type":"STPOINT","leafcount":1,"start_time":"2010-01-11 14:30:00","end_time":"2010-01-11 14:30:00","spatial":"SRID=4326;POINT(114 35)","timeline":["2010-01-11 14:30:00"],"attributes":{"leafcount":1,"velocity":{"type":"integer","length":2,"nullable":true,"value":[120]},"accuracy":{"type":"float","length":4,"nullable":false,"value":[120.0]},"bearing":{"type":"float","length":8,"nullable":false,"value":[120.0]},"acceleration":{"type":"string","length":20,"nullable":true,"value":["120"]},"active":{"type":"timestamp","length":8,"nullable":false,"value":["2010-01-01 14:30:00"]}},"events":[{"1":"2010-01-01 14:30:00"},{"2":"2010-01-01 15:00:00"},{"3":"2010-01-01 15:30:00"}]}}
  2 | {"trajectory":{"version":1,"type":"STPOINT","leafcount":1,"start_time":"2010-01-11 14:30:00","end_time":"2010-01-11 14:30:00","spatial":"SRID=4326;POINT(114 35)","timeline":["2010-01-11 14:30:00"],"attributes":{"leafcount":1,"velocity":{"type":"integer","length":2,"nullable":true,"value":[130]},"accuracy":{"type":"float","length":4,"nullable":false,"value":[130.0]},"bearing":{"type":"float","length":8,"nullable":false,"value":[130.0]},"acceleration":{"type":"string","length":20,"nullable":true,"value":["130"]},"active":{"type":"timestamp","length":8,"nullable":false,"value":["2010-01-01 15:00:00"]}},"events":[{"1":"2010-01-01 14:30:00"},{"2":"2010-01-01 15:00:00"},{"3":"2010-01-01 15:30:00"}]}}
  3 | {"trajectory":{"version":1,"type":"STPOINT","leafcount":1,"start_time":"2010-01-11 15:00:00","end_time":"2010-01-11 15:00:00","spatial":"SRID=4326;POINT(116 37)","timeline":["2010-01-11 15:00:00"],"attributes":{"leafcount":1,"velocity":{"type":"integer","length":2,"nullable":true,"value":[140]},"accuracy":{"type":"float","length":4,"nullable":false,"value":[140.0]},"bearing":{"type":"float","length":8,"nullable":false,"value":[140.0]},"acceleration":{"type":"string","length":20,"nullable":true,"value":["140"]},"active":{"type":"timestamp","length":8,"nullable":false,"value":["2010-01-01 15:30:00"]}},"events":[{"1":"2010-01-01 14:30:00"},{"2":"2010-01-01 15:00:00"},{"3":"2010-01-01 15:30:00"}]}}