Wiki-Quellcode von get_cars.php
Version 1.1 von YellowFox_RD am 2024/12/19 10:11
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 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 |