get_rs232ext.php
Table of Contents
Returns RS-232 Data with activated RS-232 Extension
Description
GET get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV&charset=ISO-8859-1
Parameters
| Parameter | Description | Type | Note | Mandatory |
|---|---|---|---|---|
| company | RTI company key | string | yes | |
| vehicle | RTI vehicle key | string | yes | |
| start | start of requested time range | datestring | format: YYYYMMDDHHMMSS between start and end maximum 7 days difference allowed | yes |
| end | end of requested time range | datestring | format: YYYYMMDDHHMMSS between start and end maximum 7 days difference allowed | yes |
| format | return format | string | CSV (default) or CSV_B64 | no |
| charset | return charset | string | default: ISO-8859-1 (alltough a free defined charset code) | no |
Return
Return a string. In case of error "ERROR:Description" will be returned.
CSV Format
Meta data
| Delimiter | semicolon ( ; ) |
|---|---|
| Text delimiter | double quote ( " ) |
| Line end | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | line 1 |
Columns
| Column | Description | |
|---|---|---|
| DATE | GPS date when measurement was created | YYYY-MM-DD HH:MM:SS |
| CAR | vehicle licence | string |
| SERIALOUTPUT | RS-232 data | string |
| LAT | Latitude | Example: 51.03659 |
| LON | Longitude | Example: 13.59967 |
Example
example in csv
"DATE";"CAR";"SERIALOUTPUT";"LAT";"LON"
"2014-03-20 11:43:01";"FLT017 (T34118.0110)";"Prop.Skalning Av";"50.83012";"13.41215"
"2014-03-20 11:43:02";"FLT017 (T34118.0110)";"Oputput Portt 1 Text";"50.83012";"13.41215"
"2014-03-20 11:43:03";"FLT017 (T34118.0110)";"Farvald Tara Av";"50.83012";"13.41215"
CSV Base 64 Format
Meta data
| Delimiter | semicolon ( ; ) |
|---|---|
| Text delimiter | double quote ( " ) |
| Line end | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | line 1 |
Columns
| Column | Description | |
|---|---|---|
| DATE | GPS date when measurement was created | YYYY-MM-DD HH:MM:SS |
| CAR | vehicle licence | string |
| SERIALOUTPUT | RS-232 data | string |
| LAT | Latitude | Example: 51.03659 |
| LON | Longitude | Example: 13.59967 |
Example
return SERIALOUTPUTB64
"DATE";"CAR";"SERIALOUTPUTB64";"LAT";"LON"
"2014-03-20 11:43:01";"FLT017 (T34118.0110)";"UHJvcC5Ta2FsbmluZyAgICAgQXY=";"50.83012";"13.41215"
"2014-03-20 11:43:02";"FLT017 (T34118.0110)";"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==";"50.83012";"13.41215"
"2014-03-20 11:43:03";"FLT017 (T34118.0110)";"RpRydmFsZCBUYXJhICBBdg==";"50.83012";"13.41215"
JSON Format (RFC 4627)
Rückgabe JSON
[{
"date":"2022-01-24 04:22:59"
,"car":"FLT017 (T34118.0110)"
,"serialoutput":"UHJvcC5Ta2FsbmluZyAgICAgQXY="
,"lat":"50.83012"
,"lon":"13.41215"
},
{
"date":"2022-01-24 04:23:01",
"car":"FLT017 (T34118.0110)",
"serialoutput":"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==",
"lat":"50.83012",
"lon":"13.41215"
}]
Example calls
Request with default CSVformat and UTF-8 charset
https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20140320000000&end=20140321000000&charset=utf-8
https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20140320000000&end=20140321000000&charset=utf-8
Request with format CSV Base 64
https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20140320000000&end=20140321000000&format=csv_b64
https://map.yellowfox.de/rti/get_rs232ext.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20140320000000&end=20140321000000&format=csv_b64