get_rs232.php
Table of Contents
Get RS-232 data.
Description
GET get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv
Parameters
| Parameter | Description | Type | Note | Mandatory |
|---|---|---|---|---|
| company | RTI company key | string | yes | |
| vehicle | RTI vehicle key | string | yes | |
| start | start of interval | datestring | format: YYYYMMDDHHMMSS maximal allowed range of 7 days between begin and end | yes |
| end | end of interval | datestring | format: YYYYMMDDHHMMSS maximal allowed range of 7 days between begin and end | yes |
| format | return format | string | csv (standard), xml, json | 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 | first line |
Columns
| Column | Description | |
|---|---|---|
| DATE | GPS date when measurement was created | YYYY-MM-DD HH:MM:SS |
| CAR | license | string |
| SERIALOUTPUT | Rs232 data | string |
Example
CSV format
return in csv
"DATE";"CAR";"SERIALOUTPUT"
"2016-05-19 14:30:02";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|2|*"
"2016-05-19 14:30:05";"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|1|*"
"2016-05-19 14:30:06";"DD-ABC 123";"PNA|0|000014A5DE88|52|425885|2|*"
XML format
return in xml
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?><!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yf_getrs232.dtd">
<yf_getrs232>
<message>
<date>2016-05-19 14:30:02</date>
<car>DD-ABC 123</car>
<serialoutput>PNA|0|000014A5DE88|52|425884|2|*</serialoutput>
</message>
<message>
<date>2016-05-19 14:30:05</date>
<car>DD-ABC 123</car>
<serialoutput>PNA|0|000014A5DE88|52|425884|1|*</serialoutput>
</message>
<message>
<date>2016-05-19 14:30:06</date>
<car>DD-ABC 123</car>
<serialoutput>PNA|0|000014A5DE88|52|425885|2|*</serialoutput>
</message>
</yf_getrs232>
JSON format (RFC 4627)
return in json
[{"date":"2016-05-19 14:30:02","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|2|*"},{"date":"2016-05-19 14:30:05","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425884|1|*"},{"date":"2016-05-19 14:30:06","car":"DD-ABC 123","serialoutput":"PNA|0|000014A5DE88|52|425885|2|*"}]
Example calls
return RS-232 data in CSV-format
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=csv
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=csv
return RS-232 data in XML-format
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=xml
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=xml
return RS-232 data in JSON-format
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20160519000101&end=20160520130001&format=json
https://map.yellowfox.de/rti/get_rs232.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20160519000101&end=20160520130001&format=json