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 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 |
| 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 |
| 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 |
| 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 |
| 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 |
| 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 |
| 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 |
| 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 |
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
[]
Updated almost 3 years ago