Wiki source code of set_tracking.php

Last modified by Dominic Lippmann on 2025/01/23 09:48
Show last authors
1 (% class="box" %)
2 (((
3 Table of Contents
4 )))
5
6 {{toc/}}
7
8 Sets the locating interval, at ignition on for a vehicle. Switches hardware specific the travel interval, time interval or course change.
9
10 = Description =
11
12 (% class="blue mark" %)//**POST**//(%%)//** set_tracking.php?company**=COMPANY_RTIKEY**&vehicle**=VEHICLE_RTIKEY**&,mode=**intelligentlocating**&value=**active//
13
14 = Parameter =
15
16 |=Parameter|=Description|=Type|=Note|=Mandatory
17 |company|RTI company key|string| |yes
18 |vehicle|RTI vehicle key|string| |yes
19 |mode|which type of locating interval should be set|string|(((
20 * coursechange
21 * distanceinterval
22 * minuteinterval
23 * intelligentlocating
24 )))|yes
25 |value|Value of the selected interval|int/string|see "Possible values"|yes
26
27 = Possible values =
28
29 |=Parameter|=Description|=Type|=Possible values
30 |coursechange|Locate at ignition on at course change|int|(((
31 * 0 = off
32 * 1 = on
33 )))
34 |distanceinterval|Locate with ignition on for all X km|int|(((
35 * 0 = Kilometer tracking deactivated
36 * 1 = Locate every km
37 * 2 = Locate every 2 km
38 * 5 = Locate every 5 km
39 * 10 = Locate every 10 km
40 )))
41 |minuteinterval|Locate with ignition on for all X min|int|(((
42 * 0 = Time interval disabled
43 * 1 = Locate every 1 minutes
44 * 2 = Locate every 2 minutes
45
46 * 5 = Locate every 5 minutes
47 * 10 = Locate every 10 minutes
48 * 15 = Locate every 15 minutes
49 * 30 = Locate every 30 minutes
50 )))
51 |intelligentlocating|when all 3 locating intervals are activated|string|(((
52 * inactive
53 * active
54 )))
55
56 = Return =
57
58 By default, a **CSV string** is returned, which contains **OK **for each vehicle on success. If an error occurs, an "**ERROR:Description**" is returned.
59
60 = Example calls =
61
62 **sets the locating interval to 5 km**
63
64 {{code language="java"}}
65 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=distanceinterval&value=5
66 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&mode=distanceinterval&value=5
67 {{/code}}
68
69 **sets the locating interval to 2 minutes**
70
71 {{code language="java"}}
72 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=minuteinterval&value=2
73 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&mode=minuteinterval&value=2
74 {{/code}}
75
76 **activates the change of course**
77
78 {{code language="java"}}
79 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=coursechange&value=1
80 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&mode=coursechange&value=1
81 {{/code}}
82
83 **activates the intelligent tracking**
84
85 {{code language="java"}}
86 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&mode=intelligentlocating&value=active
87 https://map.yellowfox.de/rti/set_tracking.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&mode=intelligentlocating&value=active
88 {{/code}}