get_cars.php

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36

Inhaltsverzeichnis

Beschreibung
Parameter
Rückgabe
- CSV
- JSON
Beispielaufrufe

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
CARNAME	Fahrzeugkennzeichen
IDENT	RTI Ident
COSTCENTER	Kostenstelle vom Fahrzeug
VEHICLEGROUPS	Fahrzeuggruppen
KMCORRECTIONFACTOR	KM Korrektur Faktor

Beispiel

Rückgabe
"CARNAME";"IDENT";"COSTCENTER";"VEHICLEGROUPS"
"CAR1";"IDENT1";"COSTCENTER1";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"
"CAR2";"IDENT2";"COSTCENTER2";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"
"CAR3";"IDENT3";"COSTCENTER3";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"
"CAR4";"IDENT4";"COSTCENTER4";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"
"CAR5";"IDENT5";"COSTCENTER5";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"
"CAR6";"IDENT6";"COSTCENTER6";"[{"name":"gruppe1"},{"name":"gruppe2"}]";"1"

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
}
]

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