Output JSON format

Details about JSON in downloaded output JSON file

Labels in a 2D and a 3D project can be downloaded in a JSON file. Output JSON file consists of a labels array object, which has the following fields:

  1. client_id (string): refers to the client ID of the dataset’s workspace.

  2. project_id (string): refers to ID of the dataset’s project.

  3. dataset_id (string): refers to ID of the dataset.

  4. file_id (string): refers to ID of the image/frame to which the label belongs to.

  5. label_category_id (string): refers to the label category of the label.

  6. label_id (string): refers to ID of label.

  7. label_type (string): refers to the type of label created. It can have values the following possible values with their corresponding description: a. box : this is a 2D bounding box label b. lane : this is a 2D lane label c. polygon : this is a 2D polygon label d. point : this is a 2D point label e. 3d_bbox : this is a 3D bounding box label f. 3d_point : this is a 3D point label g. 3d_polyline : this is a 3D polyline label h. 3d_polygon : this is a 3D polygon label

  8. attributes (object): consists of the key value pair for each label attribute.

  9. box (array): an array of 4 numbers representing a 2D bounding box. First two numbers refer to the x, y coordinates of the top left corner. Third and fourth number in the array refer to the length of the bounding box along the x and y axes respectively. This field is populated only when the label type is box.

  10. polygons (array): an array of polygons. Each polygon is an array of points. Each point is a 2-length array of x and y coordinates. This field is populated only when the label type is polygon or lane.

  11. point (array): consists of coordinates of the point. This field is populated only when the label type is point.

  12. three_d_bbox (object): has the following fields: a. l (float): refers to the length of 3D bounding box b. w (float): refers to the width of 3D bounding box c. h (float): depicts the height of the 3D bounding box d. cx (float): refers to the x coordinate of the center of the 3D bounding box e. cy (float): refers to the y coordinate of the center of the 3D bounding box f. cz (float): refers to the z coordinate of the center of the 3D bounding box g. rot_z (float): depicts the angle (in radians) made by the front face of the 3D bounding box with the negative x-axis measured in the clockwise direction. This field is populated only when the label type is 3d_bbox.

  13. three_d_point_indices (array): consists of indices of LiDAR points in the point cloud file. This field is populated only when the label type is 3d_point.

  14. three_d_polygon (array): is an array of x, y and z coordinates of different points comprising the polygon. This field is populated only when the label type is 3d_polygon.

  15. three_d_polyline (object): has the following fields: a. polyline (array) : consists of x, y and z coordinate values of the points creating polyline. b. polyline_width (float) : is the value of width of polyline. This field is populated only when the label type is 3d_polyline.