_getDT

Returns details of Geofences as a list, can also be filtered.

Parameters

start

Where details begin gathering in a list of Geofences. (e.g If at 0, all Geofences up to the limit of "length" are checked and then returned. However if set to 1, the first Geofence is skipped)

length

The amount of Geofences checked after a number assigned by "start" (e.g If length is 25 and start is 0, the first 25 Geofences are checked and their details are returned)

draw

A number assigned to each use of this function, increases by 1 each use. Useful when identifying recent versions of Geofence data

{"draw":7,"recordsTotal":"3","recordsFiltered":"3","data":[["3","Armagh Test Area","1680439033","1680439033",""],["4","Drumshanbo Test Area","1680439109","1680439109",""],["5","Monaghan Test Area","1680442839","1680442839",""]],"_poll":[]}
{"draw":6,"recordsTotal":"3","recordsFiltered":"1","data":[["4","Drumshanbo Test Area","1680439109","1680439109",""]],"_poll":[]}

From these results above, the highest has a draw value of 7, therefore it's request was more recent than the lower result.

id

An optional filter if only one particular Geofence is desired, used to find a Geofence with the chosen ID. If "id" is set to 0 or not included, it is ignored.

Examples

For these examples, the data table has only 3 Geofences, with IDs 3, 4 and 5: 3 => Armagh Test Area 4 => Drumshanbo Test Area 5 => Monaghan Test Area

Example 1

In the below example, the first 5 Geofences in a data table are skipped and the next 20 are checked to locate one with the ID of 3.

FM_api(
    'Geofences_getDT',[
      'start' => '5',
      'length' => '20',
      'draw' => '1',
      'id' => '3'
    ]
);

When this is tried, none are found with an ID of 3, because it is the first Geofence of this example, therefore it is skipped by the "start" parameter.

{"draw":1,"recordsTotal":"3","recordsFiltered":"1","data":[]}

Example 2

In the below example, the first 20 Geofences are checked without any skipped, to locate one with the ID of 3.

FM_api(
    'Geofences_getDT',[
      'start' => '0',
      'length' => '20',
      'draw' => '2',
      'id' => '3'
    ]
);

The first Geofence, being the one with an ID of 3 is returned. The other 2 Geofences are not returned because their IDs do not match the request.

{"draw":2,"recordsTotal":"3","recordsFiltered":"1",
"data":[["3","Armagh Test Area","1680439033","1680439033",""]]}

Example 3

In the below example, the first Geofence is skipped and the next 2 Geofences are checked. The IDs of the Geofences are not important for this request.

FM_api(
    'Geofences_getDT',[
      'start' => '1',
      'length' => '2',
      'draw' => '3'
    ]
);

The last 2 Geofences are returned, the first Geofence is skipped.

{"draw":3,"recordsTotal":"3","recordsFiltered":"3",
"data":[["4","Drumshanbo Test Area","1680439109","1680439109",""],
["5","Monaghan Test Area","1680442839","1680442839",""]]}

Results On Failure

If no start parameter is given or it is less than 0:

{"error":"missing or invalid parameter: start"}

If no length parameter is given or it is less than 1:

{"error":"missing or invalid parameter: length"}

If no draw parameter is given or it is less than 0:

{"error":"missing or invalid parameter: draw"}

Last updated