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
title
DATE,CAR,SERIALOUTPUT 20151023143012,
Rückgabe CSV
"DATE";"CAR";"SERIALOUTPUT"
"2016-05-19 14:30:02";"DD-ABC 123
,
";"PNA|0|000014A5DE88|52|
39
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"
"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 

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|*"}]

Example calls

Code Block
titlereturn RS-232 data in 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
titlereturn RS-232 data in 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 übertragene Daten


Code Block
title
return RS-232
data in JSON-format
https
http
://map.yellowfox.de/rti/get_rs232.
asp
php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
&begin=20151020000000&end=20151020235959&mode=CSV
&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