get_cars.php
Inhaltsverzeichnis
Zeigt eine Liste aller Fahrzeuge an, die durch den jeweiligen Request betroffen sind.
Beschreibung
GET get_cars.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle, group oder import Parameter | (ja) |
| group | RTI Gruppenschlüssel | string | entweder vehicle, group oder import Parameter | (ja) |
| import | RTI Importschlüssel | string | entweder vehicle, group oder import Parameter | (ja) |
| format | Ausgabeformat | string | csv oder json, standard: csv | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
CSV
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
Spalten
| Spalte | Beschreibung | Hinweis |
|---|---|---|
| CARNAME | Fahrzeugkennzeichen | |
| IDENT | RTI Ident | Ist ein Schlüssel, der vom Benutzer im Portal festgelegt wird und sich ändern kann. |
| COSTCENTER | Kostenstelle vom Fahrzeug | |
| VEHICLEGROUPS | Fahrzeuggruppen | |
| KMCORRECTIONFACTOR | KM Korrektur Faktor | |
| VEHICLEVIN | Fahrgestellnummer (FIN) | |
| VEHICLEIDENT | Fahrzeug Ident | Ist ein von YellowFox fest definierter und eindeutiger Schlüssel zum Fahrzeug. |
| VEHICLEDESCRIPTION | Fahrzeug Beschreibung |
|
ISTRAILER | ist das Fahrzeug ein Trailer | ja => 1, nein => 0 |
Beispiel
Rückgabe
"CARNAME";"IDENT";"COSTCENTER";"VEHICLEGROUPS";"KMCORRECTIONFACTOR";"VEHICLEVIN";"VEHICLEIDENT";"VEHICLEDESCRIPTION";"ISTRAILER"
"CAR1";"IDENT1";"COSTCENTER1";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"1DB69T687HT";"35fdebee00dfa3278fa88c54cd7f8c2f";"Transporter";0
"CAR2";"IDENT2";"COSTCENTER2";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB69T687HT";"45fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 2";0
"CAR3";"IDENT3";"COSTCENTER3";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"5DB69T687HT";"49fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 3";0
"CAR4";"IDENT4";"COSTCENTER4";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3UO69T687HT";"98fdebee00dfa3278fa88c54cd7f8c2f";"Transporter 4";0
"CAR5";"IDENT5";"COSTCENTER5";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"3DB697487HT";"4ff7debee00dfa3278fa88c54cd7f8c2f";"Anhaenger";1
"CAR6";"IDENT6";"COSTCENTER6";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1";"";"526debee00dfa3278fa88c54cd7f8c2f";"Kranwagen";0
JSON
{
"vehicle_sign": "FTL YF 123",
"rti_ident": null,
"tracking_mode": "IntelligentLocating",
"tracking_interval": 0,
"supported_modes": [
"CourseChange",
"IntelligentLocating",
"DistanceInterval",
"MinuteInterval"
],
"vehicle_groups": [
{
"name": "gruppe1"
},
{
"name": "gruppe2"
}
],
"km_correction":1,
"vehicle_vin": "1DB69T6847HT",
"vehicle_ident": "35fdebee00dfa3278fa88c54cd7f8c2f",
"vehicle_description": "Transporter",
"isTrailer": false
}
]
Beispielaufrufe
Name eines Fahrzeuges
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_RTIIDENT"}
Anzeige aller Fahrzeuge einer Gruppe
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY
Alle Fahrzeuge, die über das RTI abgefragt werden können
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY