PST SDK  6.0.0.0-272350a
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 and a position fields.
id int Representation of a 3D point marker identifier.
position JSON object Representation of a 3D point coordinates x, y, and z as doubles.
TargetPoses array of TargetPose Array of detected tracking targets, represented as "TargetPose" JSON objects.
TargetPose JSON object Represent a target, with a 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.
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
     }
    }
   },
   {
    "DataPoint" : {
     "id" : 304,
     "position" : {
      "x" : 0.11064176,
      "y" : 0.24031277,
      "z" : -0.077169955
     }
    }
   }
  ],
  "TargetPoses" : [
   {
    "TargetPose" : {
     "Points" : [
      {
       "DataPoint" : {
        "id" : 0,
        "position" : {
         "x" : -0.13181098,
         "y" : 0.15336727,
         "z" : -0.021862864
        }
       }
      },
      {
       "DataPoint" : {
        "id" : 1,
        "position" : {
         "x" : -0.023771286,
         "y" : 0.13360241,
         "z" : -0.007646501
        }
       }
      },
      {
       "DataPoint" : {
        "id" : 2,
        "position" : {
         "x" : -0.0639198,
         "y" : 0.16175072,
         "z" : -0.015122235
        }
       }
      },
      {
       "DataPoint" : {
        "id" : 3,
        "position" : {
         "x" : -0.011663303,
         "y" : 0.19799936,
         "z" : -0.011572659
        }
       }
      }
     ],
     "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