GetSingleMeasurement

Get the latest TrackerData available from the connected PST Tracker.

Endpoint

GET /PSTapi/GetSingleMeasurement  HTTP/1.1
Host: address:port

Get Request example

http://localhost:7278/PSTapi/GetSingleMeasurement

Response

The latest TrackerData retrieved from the PST Tracker.

TrackerData Object

Key	Value Type	Description
TrackerData	JSON object	Container for all tracking results of one frame.
Points	array of DataPoint	Array of detected 3D markers not matched to a tracking target, as "DataPoint" JSON objects.
DataPoint	JSON object	Representation of a 3D point with an id, a position field and a detection region field.
id	int	Representation of a 3D point marker identifier.
position	JSON object	Representation of a 3D point coordinates x, y, and z as doubles.
DetectionRegion	string	Tracking region of the detected marker. Possible values: "Optimal", "Full".
TargetPoses	array of TargetPose	Array of detected tracking targets, represented as "TargetPose" JSON objects.
TargetPose	JSON object	Represent a target, with a TargetMatchingError, TransformationMatrix, it's id, name, UUID and detected 3D markers matched.
Points	array of DataPoint	Array of detected 3D markers matched to this tracking target, as "DataPoint" JSON objects.
TargetMatchingError	matching error	RMSE in meters between the observed marker points and the fitted target model.
TransformationMatrix	array of double	Tracking target pose as a row-major 4x4 transformation matrix.
seqnumber	int	Incremental data recording id.
timestamp	double	Timestamp of the moment the cameras captured the data. The timestamp uses the system clock provided in seconds since system boot (Windows) or Epoch (Linux).

Example

"TrackerData" : {
    "Points" : [
        {
            "DataPoint" : {
                "id" : 303,
                "position" : {
                    "x" : 0.12679271,
                    "y" : 0.18989243,
                    "z" : -0.04876107
                },
                "DetectionRegion": "optimal"
            }
        },
        {
            "DataPoint" : {
                "id" : 304,
                "position" : {
                    "x" : 0.11064176,
                    "y" : 0.24031277,
                    "z" : -0.077169955
                },
                "DetectionRegion": "optimal"
            }
        }
    ],
    "TargetPoses" : [
        {
            "TargetPose" : {
                "Points" : [
                    {
                        "DataPoint" : {
                            "id" : 0,
                            "position" : {
                                "x" : -0.13181098,
                                "y" : 0.15336727,
                                "z" : -0.021862864
                            },
                            "DetectionRegion": "optimal"
                        }
                    },
                    {
                        "DataPoint" : {
                            "id" : 1,
                            "position" : {
                                "x" : -0.023771286,
                                "y" : 0.13360241,
                                "z" : -0.007646501
                            },
                            "DetectionRegion": "optimal"
                        }
                    },
                    {
                        "DataPoint" : {
                            "id" : 2,
                            "position" : {
                                "x" : -0.0639198,
                                "y" : 0.16175072,
                                "z" : -0.015122235
                            },
                            "DetectionRegion": "optimal"
                        }
                    },
                    {
                        "DataPoint" : {
                            "id" : 3,
                            "position" : {
                                "x" : -0.011663303,
                                "y" : 0.19799936,
                                "z" : -0.011572659
                            },
                            "DetectionRegion": "optimal"
                        }
                    }
                ],
                "TargetMatchingError": 0.000861010747,
                "TransformationMatrix" : [0.98451585, 0.14966916, -0.09125596, -0.057694428, -0.17010944, 0.94141203, -0.29121497, 0.16192964, 0.04232356, 0.30222926, 0.95229524, -0.012890403, 0, 0, 0, 1],
                "id" : 1,
                "name" : "Reference",
                "uuid" : "0bb57673-7e1a-4f03-9bcd-f4f7c21f62be"
            }
        }
    ],
    "seqnumber" : 0,
    "timestamp" : 448693.88845280005
}

Verification table

Status Code	Content Example	Meaning
200	JSON payload	Success message
500	{"message":"TrackerException: <...>"}	An other type of internal error