Loading...
Searching...
No Matches
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