location
#
object
The location object defines where the head is located in the scene.
Location is defined using x, y, and z global coordinates, measured in meters. Each value is a floating-point variable that can range from -5 to 5 meters.
Important
The location of the head may be the most critical setting in your data request. If the head is in the wrong place, it might not be in the camera frame and you will render nothing but the background.
Tip
Use this visualization tool to experiment with positioning the actor’s head in the frame.
The location
object contains the following fields:
"location": { "x": //The x coordinate, which moves the head from side to side "y": //The y coordinate, which moves the head from front to back "z": //The z coordinate, which moves the head down and up },
For an in-depth look at these axes, as well as which part of the head is actually located at the coordinates you set, see About our coordinate systems.
Sample usage
Location in the data request
In the JSON hierarchy of the data request, the
location
field is found here:{ "datapoints": [ { "human": { "location": { } } } ] }