get_cars.php
Table of Contents
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