Object Location

Object Location is a representation of which areas within the frame had movement within an Activity or Segment. Object Location uses a 16 by 8 grid with 128 possible locations. 0 represents the top left grid area of the video frame and 127 is the bottom right gird area. The grid is resolution independent. When transferred to and from the servers the format is represented as a sparse array of grid numbers. For this to be calculated and stored within an ActivityActivity - An event that is represented by a start time, end time, relevance and other meta-data. Activities are used to represent videos or audio activity that is part of the same sequence of frames or content. Every Activity has a unique Activity Id. Activities will only be stored for as long your service plan dictates. An Activity belongs to an Accessory. For the full list of attributes on an Activity see Get Activity by Id. Activities can be referred to as "clips" or "recordings" in the Logi Circle application., the Object Locations Feature must be present in the Service Plan Features.

Grid Number to Video Frame Representation
0123456789101112131415
16171819202122232425262728293031
32333435363738394041424344454647
48495051525354555657585960616263
64656667686970717273747576777879
80818283848586878889909192939495
96979899100101102103104105106107108109110111
112113114115116117118119120121122123124125126127

Object Location may be stored as part of an ActivityActivity - An event that is represented by a start time, end time, relevance and other meta-data. Activities are used to represent videos or audio activity that is part of the same sequence of frames or content. Every Activity has a unique Activity Id. Activities will only be stored for as long your service plan dictates. An Activity belongs to an Accessory. For the full list of attributes on an Activity see Get Activity by Id. Activities can be referred to as "clips" or "recordings" in the Logi Circle application., and is returned as part of the Get Activities by Accessory Id and Get Activities by Accessory Id calls. It is also possible to specify Object Location as part of the Activity Filter Syntax in the Get Activities by Accessory Id call to return only results which had moving objects in the grid location/s.

Definition

The motion grid is a sparse array of bit numbers where motion occurred within the grid.

attribute_name ::= "objectLocations"

value ::= number
    0..127

Examples

// Visual grid layout for bits
1000000000000000
0000000000000000
0001100000000000
0011100000000000
0001100000000000
0000000000000000
0000000000000000
0000000000000000
 
// transfer format
[0,35,36,50,51,52,67,68]
// Visual grid layout for bits
0000000000000000
0000000000000000
0000000000000000
0000000000110000
0000000000110000
0000000000000000
0000000000000000
0000000000000000
 
// transfer format
[58,59,74,75]
// Visual grid layout for bits
0000000000000000
0000000000000000
0000000000000000
0000000000000000
0000000000000000
0000000000000000
0000000000000000
0000000000000000
 
// transfer format
[]