Wiki-Quellcode von get_cars.php

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