Changes for page do_track_once.php

Last modified by YellowFox_RD on 2025/01/23 09:47

From version 2.1
edited by YellowFox_RD
on 2025/01/23 09:47
Change comment: There is no comment for this version
To version 1.1
edited by YellowFox_RD
on 2024/12/19 10:11
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -1,22 +1,15 @@
1 1  (% class="box" %)
2 -(((
3 -Table of Contents
4 -)))
5 -
2 +(((Table of Contents)))
6 6  {{toc/}}
7 7  
8 -= do_track_once.php =
9 -
5 +=== do_track_once.php ===
10 10  One time detection for a vehicle or group.
11 -
12 12  = Description =
13 -
14 -(% class="green mark" %)//**GET**//(%%)//** do_track_once.php?company**=COMPANY_RTIKEY**&vehicle**=VEHICLE_RTIKEY**&format**=xml//
15 -
8 +//**(% class="green mark" %)GET(%%) do_track_once.php?company**=COMPANY_RTIKEY**&vehicle**=VEHICLE_RTIKEY**&format**=xml
9 +//
16 16  = Parameter =
17 -
18 18  |=Parameter|=Description|=Typ|=Note|=Mandatory
19 -|company|RTI company key|string| |yes
12 +|company|RTI company key|string||yes
20 20  |vehicle|RTI vehicle key|string|either vehicle or group parameter|(yes)
21 21  |group|RTI group key|string|either vehicle or group parameter|(yes)
22 22  |format|format of the result|string|format of the result from the interface
... ... @@ -23,13 +23,10 @@
23 23  supported formats: csv (default)|no
24 24  
25 25  = Return =
26 -
27 27  By default, a **CSV string** is returned, which contains **OK **for each vehicle on success. If an error occurs, an "**ERROR:Description**" is returned.
28 28  
29 29  == CSV-Format ==
30 -
31 31  === Meta informations ===
32 -
33 33  |=Seperator|Semicolon ( ; )
34 34  |=Delimter|Double quote ( " )
35 35  |=Line Break|0x0D 0x0A (CarriageReturn LineFeed)
... ... @@ -36,13 +36,11 @@
36 36  |=Header|Line 1
37 37  
38 38  === Columns ===
39 -
40 40  |=Column|=Description
41 41  |CAR|vehicle name
42 42  |RESULT|result of the action
43 43  
44 44  === Example ===
45 -
46 46  **Result format as CSV**
47 47  {{code language="java"}}"CAR";"RESULT"
48 48  "Car 1";"OK"
... ... @@ -51,31 +51,29 @@
51 51  "Car 4";"ERROR_SEND_ONE_TIME_DETECTION"{{/code}}
52 52  
53 53  == XML Format ==
54 -
55 55  **Result format as XML**
56 56  {{code language="xml"}}<?xml version="1.0" encoding="UTF-8" standalone="no"?>
57 57  <!DOCTYPE yf_dotrackonce SYSTEM "http://map.yellowfox.de/rti/dtd/yf_dotrackonce.dtd">
58 58  <yf_dotrackonce>
59 - <tracking>
60 - <car>Car 1</car>
61 - <result>OK</result>
62 - </tracking>
63 - <tracking>
64 - <car>Car 2</car>
65 - <result>OK</result>
66 - </tracking>
67 - <tracking>
68 - <car>Car 3</car>
69 - <result>ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION</result>
70 - </tracking>
71 - <tracking>
72 - <car>Car 4</car>
73 - <result>ERROR_SEND_ONE_TIME_DETECTION</result>
74 - </tracking>
46 + <tracking>
47 + <car>Car 1</car>
48 + <result>OK</result>
49 + </tracking>
50 + <tracking>
51 + <car>Car 2</car>
52 + <result>OK</result>
53 + </tracking>
54 + <tracking>
55 + <car>Car 3</car>
56 + <result>ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION</result>
57 + </tracking>
58 + <tracking>
59 + <car>Car 4</car>
60 + <result>ERROR_SEND_ONE_TIME_DETECTION</result>
61 + </tracking>
75 75  </yf_dotrackonce>{{/code}}
76 76  
77 77  == JSON Format (RFC 4627) ==
78 -
79 79  **Result format as JSON**
80 80  {{code language="java"}}[{"car":"Car 1","result":"OK"},{"car":"Car 2","result":"OK"},{"car":"Car 3","result":"ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION"},{"car":"Car 4","result":"ERROR_SEND_ONE_TIME_DETECTION"}]{{/code}}
81 81