location#

object

The location object defines where the actor’s head - specifically, a point at the front of the neck - 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 actor is the most critical setting in your data request. If the actor is in the wrong place, they 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 actor from side to side
  "y": //The y coordinate, which moves the actor from front to back
  "z": //The z coordinate, which moves the actor down and up
},

For an in-depth look at these axes, as well as which part of the actor’s head is actually placed 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": {

        }
      }
    }
  ]
}

A sample complete location object

"location": {
  "x": 0.0,
  "y": 1.38,
  "z": 1.1
},

The above values place the actor (specifically, a point at the front of the actor’s neck) 1.38 meters behind and 1.1 meters above the origin.