get_cars.php

Last modified by YellowFox_RD on 2024/12/19 10:11

Table of Contents

Description
Parameter
Return
- CSV
- JSON
Example Calls

Shows a list of cars which are affected by a RTI request.

Description

GET get_cars.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

Parameter

Parameter	Description	Typ	Note	Mandatory
company	RTI company key	string		yes
vehicle	RTI vehicle key	string	either vehicle, group or import parameter	(yes)
group	RTI group key	string	either vehicle, group or import parameter	(yes)
import	RTI import key	string	either vehicle, group or import parameter	(yes)
format	Output format	string	csv or json, default: csv	no

Return

Return a string. In case of error it returns "ERROR:Description".

CSV

Meta informations

Separator	Semicolon ( ; )
Delimiter	Double quote ( " )
Line break	0x0D 0x0A (CarriageReturn LineFeed)
Header	Line 1
Encoding	UTF-8

Columns

Column	Description
CARNAME	name of the vehicle
IDENT	RTI Ident
COSTCENTER	cost center of the vehicle
VEHICLEGROUPS	group of vehicles
KMCORRECTIONFACTOR	km correction factor

Example

Return in CSV
"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
   }
]

Example Calls

Name of one vehicle
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"}

Returns all cars of a group
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY

All cars, which are requestable over the RTI
https://map.yellowfox.de/rti/get_cars.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY