Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Liefert per RS-232 übertragene Daten für YellowFox-Geräte mit aktivierter, erweiterter RS-232 Datenübertragung

Beschreibung

Status
colourGreen
titleGET
 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
companyRTI Firmenschlüsselstring
ja
vehicleRTI Fahrzeugschlüsselstring
ja
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

Zwischen (start) und (end) dürfen maximal sieben Tage liegen.

ja

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

Zwischen (start) und (end) dürfen maximal sieben Tage liegen.

ja
formatRückgabeformatstringCSV (Standard) oder CSV_B64nein
charsetRückgabe ZeichensatzstringStandard: 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

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

Spalte
Beschreibung

DATEGPS Datum wann die Meldung erzeugt wurde YYYY-MM-DD HH:MM:SS
CARFahrzeugkennzeichenstring
SERIALOUTPUTper RS-232 übertragene Datenstring
LATLatitudeBsp.: 51.03659
LONLongitudeBsp.: 13.59967

Beispiel

Code Block
titleRü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

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

Spalte
Beschreibung

DATEGPS Datum wann die Meldung erzeugt wurde YYYY-MM-DD HH:MM:SS
CARFahrzeugkennzeichenstring
SERIALOUTPUTper RS-232 übertragene Datenstring
LATLatitudeBsp.: 51.03659
LONLongitudeBsp.: 13.59967

Beispiel

Code Block
titleRü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)

Code Block
titleRü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

Code Block
titleAbfrage 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


Code Block
titleAbfrage 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



...