Wiki-Quellcode von get_cars.php
Zuletzt geändert von YellowFox_RD am 2025/09/02 15:06
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 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|=Hinweis | ||
| 39 | |CARNAME|Fahrzeugkennzeichen| | ||
| 40 | |IDENT|RTI Ident|Ist ein Schlüssel, der vom Benutzer im Portal festgelegt wird und sich ändern kann. | ||
| 41 | |COSTCENTER|Kostenstelle vom Fahrzeug| | ||
| 42 | |VEHICLEGROUPS|Fahrzeuggruppen| | ||
| 43 | |KMCORRECTIONFACTOR|KM Korrektur Faktor| | ||
| 44 | |VEHICLEVIN|Fahrgestellnummer (FIN)| | ||
| 45 | |VEHICLEIDENT|Fahrzeug Ident|Ist ein von YellowFox fest definierter und eindeutiger Schlüssel zum Fahrzeug. | ||
| 46 | |VEHICLEDESCRIPTION|Fahrzeug Beschreibung|((( | ||
| 47 | |||
| 48 | ))) | ||
| 49 | |((( | ||
| 50 | ISTRAILER | ||
| 51 | )))|ist das Fahrzeug ein Trailer|ja => 1, nein => 0 | ||
| 52 | |||
| 53 | === Beispiel === | ||
| 54 | |||
| 55 | **Rückgabe** | ||
| 56 | {{code language="java"}}"CARNAME";"IDENT";"COSTCENTER";"VEHICLEGROUPS";"KMCORRECTIONFACTOR";"VEHICLEVIN";"VEHICLEIDENT";"VEHICLEDESCRIPTION";"ISTRAILER" | ||
| 57 | "CAR1";"IDENT1";"COSTCENTER1";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"1DB69T687HT";"35fdebee00dfa3278fa88c54cd7f8c2f";"Transporter";0 | ||
| 58 | "CAR2";"IDENT2";"COSTCENTER2";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB69T687HT";"45fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 2";0 | ||
| 59 | "CAR3";"IDENT3";"COSTCENTER3";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"5DB69T687HT";"49fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 3";0 | ||
| 60 | "CAR4";"IDENT4";"COSTCENTER4";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3UO69T687HT";"98fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 4";0 | ||
| 61 | "CAR5";"IDENT5";"COSTCENTER5";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB697487HT";"4ff7debee00dfa3278fa88c54cd7f8c2f";"Anhaenger";1 | ||
| 62 | "CAR6";"IDENT6";"COSTCENTER6";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"";"526debee00dfa3278fa88c54cd7f8c2f";"Kranwagen";0{{/code}} | ||
| 63 | |||
| 64 | == JSON == | ||
| 65 | |||
| 66 | {{code language="json"}} | ||
| 67 | [ | ||
| 68 | { | ||
| 69 | "vehicle_sign": "FTL YF 123", | ||
| 70 | "rti_ident": null, | ||
| 71 | "tracking_mode": "IntelligentLocating", | ||
| 72 | "tracking_interval": 0, | ||
| 73 | "supported_modes": [ | ||
| 74 | "CourseChange", | ||
| 75 | "IntelligentLocating", | ||
| 76 | "DistanceInterval", | ||
| 77 | "MinuteInterval" | ||
| 78 | ], | ||
| 79 | "vehicle_groups": [ | ||
| 80 | { | ||
| 81 | "name": "gruppe1" | ||
| 82 | }, | ||
| 83 | { | ||
| 84 | "name": "gruppe2" | ||
| 85 | } | ||
| 86 | ], | ||
| 87 | "km_correction":1, | ||
| 88 | "vehicle_vin": "1DB69T6847HT", | ||
| 89 | "vehicle_ident": "35fdebee00dfa3278fa88c54cd7f8c2f", | ||
| 90 | "vehicle_description": "Transporter", | ||
| 91 | "isTrailer": false | ||
| 92 | } | ||
| 93 | ] | ||
| 94 | {{/code}} | ||
| 95 | |||
| 96 | = Beispielaufrufe = | ||
| 97 | |||
| 98 | **Name eines Fahrzeuges** | ||
| 99 | {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY | ||
| 100 | |||
| 101 | https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_RTIIDENT"}{{/code}} | ||
| 102 | |||
| 103 | **Anzeige aller Fahrzeuge einer Gruppe** | ||
| 104 | {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY{{/code}} | ||
| 105 | |||
| 106 | **Alle Fahrzeuge, die über das RTI abgefragt werden können** | ||
| 107 | {{code language="java"}}https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY{{/code}} | ||
| 108 |