get_rs232.php
Inhaltsverzeichnis
Liefert per RS-232 übertragene Daten.
Beschreibung
GET get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | ja | |
| start | Anfang des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS Zwischen (begin) und (end) dürfen maximal sieben Tage liegen. | ja |
| end | Ende des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS Zwischen (begin) und (end) dürfen maximal sieben Tage liegen. | ja |
| format | Rückgabeformat | string | csv (Standard), xml, json | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
CSV Format
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| DATE | GPS Datum wann die Meldung erzeugt wurde | YYYY-MM-DD HH:MM:SS |
| CAR | Fahrzeugkennzeichen | string |
| SERIALOUTPUT | per RS-232 übertragene Daten | string |
Beispiel
CSV Format
Rückgabe 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
Rückgabe 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)
Rückgabe 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|*"}]
Beispielaufrufe
Liefert per RS-232 übertragene Daten im 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
Liefert per RS-232 übertragene Daten im 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
Liefert per RS-232 übertragene Daten im 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