Wiki-Quellcode von get_cars.php

Zuletzt geändert von YellowFox_RD am 2025/04/17 10:03

Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((
3 Inhaltsverzeichnis
4 )))
5
6 {{toc/}}
7
8 Zeigt eine Liste aller Fahrzeuge an, die durch den jeweiligen Request betroffen sind.
9
10 = Beschreibung =
11
12 (% class="green mark" %)**GET**(%%)** get_cars.php?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//
13
14 = Parameter =
15
16 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
17 |company|RTI Firmenschlüssel|string| |ja
18 |vehicle|RTI Fahrzeugschlüssel|string|entweder vehicle, group oder import Parameter|(ja)
19 |group|RTI Gruppenschlüssel|string|entweder vehicle, group oder import Parameter|(ja)
20 |import|RTI Importschlüssel|string|entweder vehicle, group oder import Parameter|(ja)
21 |format|Ausgabeformat|string|csv oder json, standard: csv|nein
22
23 = Rückgabe =
24
25 Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
26
27 == CSV ==
28
29 === Metainformationen ===
30
31 |=Trennzeichen|Semikolon ( ; )
32 |=Textbegrenzer|Doppeltes Hochkomma ( " )
33 |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed)
34 |=Header|Zeile 1
35
36 === Spalten ===
37
38 |=Spalte|=Beschreibung
39 |CARNAME|Fahrzeugkennzeichen
40 |IDENT|RTI Ident
41 |COSTCENTER|Kostenstelle vom Fahrzeug
42 |VEHICLEGROUPS|Fahrzeuggruppen
43 |KMCORRECTIONFACTOR|KM Korrektur Faktor
44 |VEHICLEVIN|Fahrgestellnummer (FIN)
45 |VEHICLEIDENT|Fahrzeug Ident
46 |VEHICLEDESCRIPTION|Fahrzeug Beschreibung
47
48 === Beispiel ===
49
50 **Rückgabe**
51 {{code language="java"}}"CARNAME";"IDENT";"COSTCENTER";"VEHICLEGROUPS";"KMCORRECTIONFACTOR";"VEHICLEVIN";"VEHICLEIDENT";"VEHICLEDESCRIPTION"
52 "CAR1";"IDENT1";"COSTCENTER1";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"1DB69T687HT";"35fdebee00dfa3278fa88c54cd7f8c2f";"Transporter"
53 "CAR2";"IDENT2";"COSTCENTER2";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB69T687HT";"45fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 2"
54 "CAR3";"IDENT3";"COSTCENTER3";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"5DB69T687HT";"49fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 3"
55 "CAR4";"IDENT4";"COSTCENTER4";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3UO69T687HT";"98fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 4"
56 "CAR5";"IDENT5";"COSTCENTER5";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB697487HT";"4ff7debee00dfa3278fa88c54cd7f8c2f";"Transporter 5"
57 "CAR6";"IDENT6";"COSTCENTER6";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"";"526debee00dfa3278fa88c54cd7f8c2f";"Kranwagen"{{/code}}
58
59 == JSON ==
60
61 {{code language="json"}}
62 [
63 {
64 "vehicle_sign": "FTL YF 123",
65 "rti_ident": null,
66 "tracking_mode": "IntelligentLocating",
67 "tracking_interval": 0,
68 "supported_modes": [
69 "CourseChange",
70 "IntelligentLocating",
71 "DistanceInterval",
72 "MinuteInterval"
73 ],
74 "vehicle_groups": [
75 {
76 "name": "gruppe1"
77 },
78 {
79 "name": "gruppe2"
80 }
81 ],
82 "km_correction":1,
83 "vehicle_vin": "1DB69T6847HT",
84 "vehicle_ident": "35fdebee00dfa3278fa88c54cd7f8c2f",
85 "vehicle_description": "Transporter"
86 }
87 ]
88 {{/code}}
89
90 = Beispielaufrufe =
91
92 **Name eines Fahrzeuges**
93 {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
94
95 https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_RTIIDENT"}{{/code}}
96
97 **Anzeige aller Fahrzeuge einer Gruppe**
98 {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY{{/code}}
99
100 **Alle Fahrzeuge, die über das RTI abgefragt werden können**
101 {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY{{/code}}
102