Versions Compared

Key

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

Liefert per RS-232 übertragene Daten.

Beschreibung

...

Status
colourGreen
titleGET
 get

...

_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring

...


ja
vehicleRTI Fahrzeugschlüsselstring

...


ja
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

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

ja

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

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

ja
formatRückgabeformatstringcsv (Standard), xml, jsonnein

...

Rückgabe

...

  Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

CSV Format

Metainformationen

Trennzeichen

...

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

Spalten

SpalteBeschreibung

...


DATEGPS Datum wann die Meldung erzeugt wurde

...

 YYYY-MM-DD HH:MM:SS
CARFahrzeugkennzeichen

...

string
SERIALOUTPUTper RS-232 übertragene Daten

...

string

Beispiel

CSV Format

Code Block
titleRückgabe CSV
"DATE
,CAR,SERIALOUTPUT 20151023143012,
";"CAR";"SERIALOUTPUT"
"2016-05-19 14:30:02";"DD-ABC 123
,
";"PNA|0|000014A5DE88|
39
52|425884|
4061|ga:102|0|*" 20151023143024,
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|
39
52|
4042|ga:103|0
425885|2|*"

 XML Format 

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

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

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


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


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


Sv translation
languageen

Get RS-232 data.

Description

Status
colourGreen
titleGET
 get_rs232.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv

Parameters

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
vehicleRTI vehicle keystring
yes
startstart of intervaldatestring

format: YYYYMMDDHHMMSS

maximal allowed range of 7 days between begin and end

yes

endend of intervaldatestring

format: YYYYMMDDHHMMSS

maximal allowed range of 7 days between begin and end

yes
formatreturn formatstringcsv (standard), xml, jsonno

Return

 Return a string. In case of error "ERROR:Description" will be returned.

CSV format

meta data

Delimitersemicolon ( ; )
Text delimiterdouble quote ( " )
Line end0x0D 0x0A (CarriageReturn LineFeed)
Headerfirst line

Columns

ColumnDescription
DATEGPS date when measurement was created YYYY-MM-DD HH:MM:SS
CARlicensestring
SERIALOUTPUTRs232 datastring

Example

CSV format

Code Block
titlereturn in csv
"DATE";"CAR";"SERIALOUTPUT"

 

JSON Format (RFC 4627)

[{

...

"2016-05-19 14:30:02"

...

      "car": "Nico Entwbr\u00e4tt",

...

;"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|2|*"

...

   }, {

...


"2016-05-19 14:30:05"

...

      "car": "Nico Entwbr\u00e4tt",

...

;"DD-ABC 123";"PNA|0|000014A5DE88|52|425884|1|*"

...

   }, {

...


"2016-05-19 14:30:06

...

      "car": "Nico Entwbr\u00e4tt",

...

";"DD-ABC 123";"PNA|0|000014A5DE88|52|425885|2|*"

 XML format 

Code Block
titlereturn 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)

Code Block
titlereturn 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|*"

...

}]

 

Liefert per übertragene Daten im FormatLiefert per übertragene Daten im FormatLiefert per übertragene Daten im Format

Example calls

Code Block
title
return RS-232
data in CSV-
format
http
https://
dev
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


Code Block
title
return RS-232
data in XML-
format
http
https://
dev
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


Code Block
title
return RS-232
data in JSON-
format
http
https://
dev
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