Versions Compared

Old Version 14

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

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ückgabewert

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
CARFahrzeugkennzeichen
String
string
SERIALOUTPUTper RS-232 übertragene Daten
String
string
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:0102";"FLT017 (T34118.0110)";"Oputput Portt 1         Text";"50.83012";"13.41215"
"2014-03-20 11:43:0103";"FLT017 (T34118.0110)";"F"rvaldFarvald 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
CARFahrzeugkennzeichen
String
string
SERIALOUTPUTper RS-232 übertragene Daten
String
string
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:0102";"FLT017 (T34118.0110)";"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==";"50.83012";"13.41215"
"2014-03-20 11:43:0103";"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
httphttps://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
httphttps://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



Sv translation
languageen

Returns RS-232 Data with activated RS-232 Extension

Description

Status
colourGreen
titleGET
 get_rs232ext.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=CSV&charset=ISO-8859-1

Parameters

parameter
Parameter
description
Description
type
Type
note
Note
mandatory
Mandatory
companyRTI company keystring
 

yes
vehicleRTI vehicle keystring
 

yes
startstart of requested time rangedatestring

format: YYYYMMDDHHMMSS

between start and end maximum 7 days difference allowed

yes

endend of requested time rangedatestring

format: YYYYMMDDHHMMSS

between start and end maximum 7 days difference allowed

yes
formatreturn formatstringCSV (
Standard
default) or CSV_B64no
charsetreturn charsetstringdefault: 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

Meta data

delimiter
Delimitersemicolon ( ; )
text
Text delimiterdouble quote ( " )
line
Line end0x0D 0x0A (CarriageReturn LineFeed)
header
Header
Line
line 1

Columns

column
Column
description
 
Description

DATEGPS date when measurement was created YYYY-MM-DD HH:MM:SS
CARvehicle licencestring
SERIALOUTPUTRS-232 datastring
LATLatitudeExample: 51.03659
LONLongitudeExample: 13.59967

Example

Code Block
titleexample 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:0102";"FLT017 (T34118.0110)";"Oputput Portt 1         Text";"50.83012";"13.41215"
"2014-03-20 11:43:0103";"FLT017 (T34118.0110)";"F"rvaldFarvald Tara  Av";"50.83012";"13.41215"

CSV Base 64 Format

meta

Meta data

delimiter
Delimitersemicolon ( ; )
text
Text delimiterdouble quote ( " )
line
Line end0x0D 0x0A (CarriageReturn LineFeed)
header
Headerline 1

Columns

column
Column
description
 
Description

DATEGPS date when measurement was created YYYY-MM-DD HH:MM:SS
CARvehicle licencestring
SERIALOUTPUTRS-232 datastring
LATLatitudeExample: 51.03659
LONLongitudeExample: 13.59967

Example

Code Block
titlereturn 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:0102";"FLT017 (T34118.0110)";"T3B1dHB1dCBQb3J0dCAxICAgICAgICAgVGV4dA==";"50.83012";"13.41215"
"2014-03-20 11:43:0103";"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"
}]

Example

Calls

calls

Code Block
titleRequest with default CSVformat and UTF-8 charset
httphttps://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
titleRequest with format CSV Base 64
httphttps://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