get_rs232ext.php
Inhaltsverzeichnis
Liefert per RS-232 übertragene Daten für YellowFox-Geräte mit aktivierter, erweiterter RS-232 Datenübertragung
Beschreibung
GET get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV&charset=ISO-8859-1
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 (start) und (end) dürfen maximal sieben Tage liegen. | ja |
| end | Ende des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS Zwischen (start) und (end) dürfen maximal sieben Tage liegen. | ja |
| format | Rückgabeformat | string | CSV (Standard) oder CSV_B64 | nein |
| charset | Rückgabe Zeichensatz | string | Standard: ISO-8859-1 (ansonsten jeder beliebiger Charset Typ) | 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 |
| LAT | Latitude | Bsp.: 51.03659 |
| LON | Longitude | Bsp.: 13.59967 |
Beispiel
Rückgabe SERIALOUTPUT
"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
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 |
| LAT | Latitude | Bsp.: 51.03659 |
| LON | Longitude | Bsp.: 13.59967 |
Beispiel
Rückgabe 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"
}]
Beispielaufrufe
Abfrage im Standard CSV mit Zeichensatz UTF-8
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
Abfrage im 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