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.

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