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 Activity, 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 Activity, 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
[]