Versions Compared

Old Version 20

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

Gibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.

Wird keine Zeitraumbegrenzung (start und end) mitgegeben, wird die jeweilig aktuelle Position zurückgeliefert.

Beschreibung

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

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
 

ja
vehicleRTI Fahrzeugschlüsselstringentweder vehicle oder group Parameter(ja)
groupRTI Gruppenschlüsselstringentweder vehicle oder group Parameter(ja)
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

es wird das Datum der Meldungsverarbeitung(insertdate) verwendet

nein

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

nein
query_dateDatum zu welchen Zeitpunkt die jeweilige Position angezeigt werden solldatestringFormat: YYYYMMDDHHMMSS
es wird das Datum der Meldungsverarbeitung(insertdate) verwendet
nein
formatRückgabeformatstringcsv (Standard) xml, jsonnein

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

date_queryWelches Datum bildet die Grundlage für die Zeitraumeingrenzungstring

'insert' (Standard) = Verarbeitungsdatum

'gps' = Datum an dem die Positionsmeldung stattgefunden hat

nein
additionaldataZusätzliche Parameter um bestimmte Informationen zusätzlich zu erhalten, per Komma getrennt string'temp' holt die Temperaturwerte der Digitalen Sensoren 1-8 und Analogen Sensoren 1-4nein
hide_displayBlendet Meldungen vom Display ausint
  • 0 (Standard) = Displaymeldungen werden mit ausgegeben
  • 1 = Displaymeldungen werden nicht mit ausgegeben
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


SpalteBeschreibung
1VEHICLEFahrzeugkennzeichen
2DATEGPS Datum wann die Meldung erzeugt wurdeFormat
SpalteBeschreibung VEHICLEFahrzeugkennzeichen DATEGPS Datum wann die Meldung erzeugt wurdeFormat
: YYYY-MM-DD HH:MM:SS
3LATLatitudeBsp.: 51.03659
4LONLongitudeBsp.: 13.59967
5POSAdresse
 

6DIRRichtung in ganzen Grad0=Nord, 90=Ost
7SATAnzahl Satelliten
 

8SPEEDGeschwindigkeit in ganzen km/h
 

9IGNZündungsstatus0 = Aus, 1 = An, null = undefiniert
10REASONGrund der Meldung
 

11KMKilometerstand in ganzen km
 

12INSERTDATEDatum wann die Meldung im Rechenzentrum verarbeitet wurdeFormat: YYYY-MM-DD HH:MM:SS
13UTCDATEUTC Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
14DRIVERName des angemeldeten Fahrer
 

15CUSTOMERKundennamefalls sich die Position einer Kundenadresse zuordnen lässt
16DRIVER_KEYFahrerschlüssel
 

17ETA_TIMEErwartete Ankunftszeit am NavigationszielFormat: YYYY-MM-DD HH:MM:SS
18ETA_DISTErwartete Distanz bis zum Navigationsziel in Kilometer
 

19ETA_DURErwartete Dauer bis zum Navigationsziel in Sekunden
 

20ETA_LATLatitute Koordinate des NavigationszielsBsp.: 51.03659
21ETA_LONLongitude Koordinate des NavigationszielsBsp.: 13.59967
22ETA_DESCKundenadresszuordnung des Navigationszielsfalls sich die Position einer Kundenadresse zuordnen lässt
23BSZ1Betriebsstundenzähler 1Wert in ganzen Minuten
24BSZ2Betriebsstundenzähler 2Wert in ganzen Minuten

Beispiel

Code Block
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"DRIVER_KEY";"ETA_TIME";"ETA_DIST";"ETA_DUR";"ETA_LAT";"ETA_LON";"ETA_DESC";"BSZ1";"BSZ2"
"353234024326181";"2015-04-15 08:52:42";"51.03669";"13.59925";"D-01723 Wilsdruff Am Wüsteberg 3";"207";"10";"0";"0";"Nachrichtstatus aktualisiert";"52469";"2015-04-15 08:52:57";"2015-04-15 06:52:42";"Herr Mueller";"YellowFox GmbH";"123456";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller";"1234";""

 

XML Format

Code Block
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "http://map.yellowfox.de/rti/dtd/yfrtiout-1.2.dtd">
<yfrtiout>
   <message>
      <vehsign>353234024326181</vehsign>
      <date>2015-04-15 08:52:42</date>
      <lat>51.03669</lat>
      <lon>13.59925</lon>
      <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos>
      <dir>207</dir>
      <sat>10</sat>
      <speed>0</speed>
      <ign>0</ign>
      <reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <insertdate>2015-04-15 08:52:57</insertdate>
      <utcdate>2015-04-15 06:52:42</utcdate>
      <driver>Herr Mueller</driver>
      <customer>YellowFox GmbH</customer>
	  <driverkey>123456</driverkey>
	  <eta_time>2015-04-15 09:52:42</eta_time>
	  <eta_dist>12.33</eta_dist>
	  <eta_dur>3600</eta_dur>
	  <eta_lat>50.862247</eta_lat>
	  <eta_lon>12.908245</eta_lon>
	  <eta_desc>Kunde Mueller</eta_desc>
      <bsz1>1234</bsz1>
      <bsz2></bsz2>
   </message>
</yfrtiout>

JSON Format (RFC 4627)

Code Block
[{"vehsign":"A9 Peter Stimpel","date":"2016-05-23 08:13:24","lat":"51.0365","lon":"13.5997","pos":null,"dir":"40","sat":"14","speed":"0","ign":"0","reason":"Telemetriemeldung","km":"49929","insertdate":"2016-05-23 08:13:41","utcdate":"2016-05-23 
06:13:24","driver":"Herr Mueller","customer":"Kunde Mueller","driverkey":"12345","eta_time":null,"eta_dist":"2015-04-15 09:52:42","eta_dur":"3600","eta_lat":"50.862247","eta_lon":"12.908245","eta_desc":"Kunde Mueller","bsz1":"1234","bsz2":""}]

 Beispielaufrufe

Code Block
titleAktuelle Position eines Fahrzeuges im CSV Format
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
Code Block
titlePositionen eines Fahrzeuges in einem bestimmten Zeitraum im XML Format
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml

 

 

25DRIVER2Name des angemeldeten Beifahrers
26DRIVER_KEY2Fahrerschlüssel vom Beifahrer
27D_INPUT_1Digitaler Eingang 1 Wert0 = aus 1 = an
28D_INPUT_2Digitaler Eingang 2 Wert0 = aus 1 = an
29D_INPUT_3Digitaler Eingang 3 Wert0 = aus 1 = an
30D_INPUT_4Digitaler Eingang 4 Wert0 = aus 1 = an
31D_INPUT_5Digitaler Eingang 5 Wert0 = aus 1 = an
32D_INPUT_6Digitaler Eingang 6 Wert0 = aus 1 = an
33D_INPUT_TEXTSTATE_1Digitaler Eingang 1 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
34D_INPUT_TEXTSTATE_2Digitaler Eingang 2 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
35D_INPUT_TEXTSTATE_3Digitaler Eingang 3 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
36D_INPUT_TEXTSTATE_4Digitaler Eingang 4 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
37D_INPUT_TEXTSTATE_5Digitaler Eingang 5 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
38D_INPUT_TEXTSTATE_6Digitaler Eingang 6 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
39RTI_IDENTRTI Ident des Fahrzeuges
40PRIVFLAGPrivatfahrt Status0 = aus / 1 = an

Zusatzspalten

Die folgenden Spalten werden ausschließlich bei Angabe eines Zusatzparameters mit ausgeliefert:

ParameterSpalteBeschreibung
temp

DIGITAL_TEMPERATURE_1
Wert des digitalen Eingangs 1
DIGITAL_TEMPERATURE_2
Wert des digitalen Eingangs 2
DIGITAL_TEMPERATURE_3
Wert des digitalen Eingangs 3
DIGITAL_TEMPERATURE_4
Wert des digitalen Eingangs 4
DIGITAL_TEMPERATURE_5
Wert des digitalen Eingangs 5
DIGITAL_TEMPERATURE_6
Wert des digitalen Eingangs 6
DIGITAL_TEMPERATURE_7
Wert des digitalen Eingangs 7
DIGITAL_TEMPERATURE_8
Wert des digitalen Eingangs 8
DIGITAL_TEMPERATURE_1_SET_POINT
Richtwert des digitalen Eingangs 1
DIGITAL_TEMPERATURE_2_SET_POINT
Richtwert des digitalen Eingangs 2
DIGITAL_TEMPERATURE_3_SET_POINT
Richtwert des digitalen Eingangs 3
DIGITAL_TEMPERATURE_4_SET_POINT
Richtwert des digitalen Eingangs 4
DIGITAL_TEMPERATURE_5_SET_POINT
Richtwert des digitalen Eingangs 5
DIGITAL_TEMPERATURE_6_SET_POINT
Richtwert des digitalen Eingangs 6
DIGITAL_TEMPERATURE_7_SET_POINT
Richtwert des digitalen Eingangs 7
DIGITAL_TEMPERATURE_8_SET_POINT
Richtwert des digitalen Eingangs 8
ANALOGUE_TEMPERATURE_1
Wert des analogen Eingangs 1
ANALOGUE_TEMPERATURE_2
Wert des analogen Eingangs 2
ANALOGUE_TEMPERATURE_3
Wert des analogen Eingangs 3
ANALOGUE_TEMPERATURE_4
Wert des analogen Eingangs 4


Beispiel

Code Block
titlePositions-Rückgabe
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"DRIVER_KEY";"ETA_TIME";"ETA_DIST";"ETA_DUR";"ETA_LAT";"ETA_LON";"ETA_DESC";"BSZ1";"BSZ2";"DRIVER2";"DRIVER_KEY2";"D_INPUT_1";"D_INPUT_2";"D_INPUT_3";"D_INPUT_4";"D_INPUT_5";"D_INPUT_6";"D_INPUT_TEXTSTATE_1";"D_INPUT_TEXTSTATE_2";"D_INPUT_TEXTSTATE_3";"D_INPUT_TEXTSTATE_4";"D_INPUT_TEXTSTATE_5";"D_INPUT_TEXTSTATE_6";"RTI_IDENT";"PRIVFLAG"
"353234024326181";"2015-04-15 08:52:42";"51.03669";"13.59925";"D-01723 Wilsdruff Am Wüsteberg 3";"207";"10";"0";"0";"Nachrichtstatus aktualisiert";"52469";"2015-04-15 08:52:57";"2015-04-15 06:52:42";"Herr Mueller";"YellowFox GmbH";"123456";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller";"1234";"";"DF1234567890";"John Who";"0";"0";"1";"0";"0";"1";"Temp Innen@aus";"Temp Aussen@aus";"";"Pumpe@offen";"";"Hydraulik@up";"Ident1";"1"


XML Format

Code Block
titlePositions-Rückgabe XML
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yfrtiout-1.4.dtd">
<yfrtiout>
   <message>
      <vehsign>353234024326181</vehsign>
      <date>2015-04-15 08:52:42</date>
      <lat>51.03669</lat>
      <lon>13.59925</lon>
      <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos>
      <dir>207</dir>
      <sat>10</sat>
      <speed>0</speed>
      <ign>0</ign>
      <reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <insertdate>2015-04-15 08:52:57</insertdate>
      <utcdate>2015-04-15 06:52:42</utcdate>
      <driver>Herr Mueller</driver>
      <customer>YellowFox GmbH</customer>
	  <driverkey>123456</driverkey>
	  <eta_time>2015-04-15 09:52:42</eta_time>
	  <eta_dist>12.33</eta_dist>
	  <eta_dur>3600</eta_dur>
	  <eta_lat>50.862247</eta_lat>
	  <eta_lon>12.908245</eta_lon>
	  <eta_desc>Kunde Mueller</eta_desc>
      <bsz1>1234</bsz1>
      <bsz2></bsz2>
      <driver2>John Who</driver2>
	  <driverkey2>DF1234567890</driverkey2>
	  <digital_inputs>
		<d_in>
			<d_nr>1</d_nr>
			<d_name>Temp Innen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>2</d_nr>
			<d_name>Temp Aussen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>4</d_nr>
			<d_name>Pumpe</d_name>
			<d_state>offen</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>6</d_nr>
			<d_name>Hydraulik</d_name>
			<d_state>up</d_state>
			<d_value>1</d_value>
		</d_in>
	</digital_inputs>
	<rti_ident>Ident1</rti_ident>
 	<privflag>1</privflag>
	<digital_temperature_values>
		<d_temp>
			<nr>1</nr>
			<value>10.5</value>
			<set_point>11</set_point>
		</d_temp>
	</digital_temperature_values>
	<analogue_temperature_values>
		<a_temp>
			<nr>1</nr>
			<value>-5</value>
		</a_temp>
	</analogue_temperature_values>
</yfrtiout>

JSON Format (RFC 4627)

Code Block
titlePositions-Rückgabe JSON
[
    {
        "vehsign": "353234024326181",
        "date": "2016-05-23 08:13:24",
        "lat": "51.0365",
        "lon": "13.5997",
        "pos": "D-01723 Wilsdruff (Kesselsdorf) Am Wüsteberg 3",
        "dir": "40",
        "sat": "14",
        "speed": "0",
        "ign": "0",
        "reason": "Telemetriemeldung",
        "km": "49929",
        "insertdate": "2016-05-23 08:13:41",
        "utcdate": "2016-05-23 06:13:24",
        "driver": "Herr Mueller",
        "customer": "Kunde Mueller",
        "driverkey": "12345",
        "eta_time": "2015-04-15 09:52:42",
        "eta_dist": "2015-04-15 09:52:42",
        "eta_dur": "3600",
        "eta_lat": "50.862247",
        "eta_lon": "12.908245",
        "eta_desc": "Kunde Mueller",
        "bsz1": "1234",
        "bsz2": "",
        "driver2": "John Who",
        "driverkey2": "DF1234567890",
        "digital_inputs": [
            {
                "nr": 1,
                "name": "Temp Innen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 2,
                "name": "Temp Aussen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 4,
                "name": "Pumpe",
                "state": "offen",
                "value": "0"
            },
            {
                "nr": 6,
                "name": "Hydraulik",
                "state": "up",
                "value": "1"
            }
        ],
		"rti_ident": "Ident1",
		"privflag": "1",
		"digital_temperature_values": [
			{
				"nr": 1,
				"value": 10.5,
				"set_point": 11
			}
		],
		"analogue_temperature_values": [
			{
				"nr": 1,
				"value": -5
			}
		]
    }
]

 Beispielaufrufe

Code Block
titleAktuelle Position eines Fahrzeuges im CSV Format
https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}


Code Block
titlePositionen eines Fahrzeuges in einem bestimmten Zeitraum im XML Format
https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml

https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20150401000000&end=20150401235959&format=xml



Sv translation
languageen

Returns position data for the requested vehicle or vehicle group.

If no start and end are given, current position will be returned.

Description

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

Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
vehicleRTI vehcile keystringvehicle or group parameter(yes)
groupRTI group keystringvehicle or group parameter(yes)
startbegin of requested timerangedatestring

Format: YYYYMMDDHHMMSS

no

endend of requested timerangedatestring

Format: YYYYMMDDHHMMSS

no
query_datedate at which the respective position is to be displayeddatestringFormat: YYYYMMDDHHMMSSno
formatreturn formatstringcsv (default) or xmlno
date_queryset the date reference for requeststring

'insert' (default) = get bookings by processing time

'gps' = get booking by booked date and time

no
additionaldataadditional params to gather certain additional informationstring'temp' gathers the values of digital temperature inputs 1 to 8 and analogue temperature inputs 1 to 4no
hide_displayhides messages from the displayint
  • 0 (Standard) = display messages are also output
  • 1 = display messages are not output
no

Return

Return a string. In case of error it returns "ERROR:Description".

CSV Format

Meta informations

Separatorsemicolon ( ; )
Delimiterdouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
Headerline 1

Columns

ColumnDescription
VEHICLEvehicle licence
DATEGPS date of message creationFormat: YYYY-MM-DD HH:MM:SS
LATLatitudeExample.: 51.03659
LONLongitudeExample.: 13.59967
POSadress text
DIRdirection in grade0=North, 90=East
SATAnzahl Satelliten
SPEEDspeed in full km/h
IGNignition state0 = off, 1 = on, , null = undefined
REASONreason of the message
KModometer value in full km
INSERTDATEDate when the message was processed in the data centerFormat: YYYY-MM-DD HH:MM:SS
UTCDATEUTC date of message creationFormat: YYYY-MM-DD HH:MM:SS
DRIVERname of logged in driver
CUSTOMERcustomer namein case of a possible customer position allocation
DRIVER_KEYdriver key
ETA_TIMEestimated time of arrival at navigation targetFormat: YYYY-MM-DD HH:MM:SS
ETA_DISTestimated time of arrival at navigation target in kilometer
ETA_DURestimated duration of arrival at navigation target in seconds
ETA_LATLatitute coordinate of navigation targetBsp.: 51.03659
ETA_LONLongitude coordinate of navigation targetBsp.: 13.59967
ETA_DESCcustomer allocation of navigation targetin case of a possible customer position allocation
BSZ1operation time counter 1value in full minutes
BSZ2operation time counter 2value in full minutes
DRIVER2name of logged in co-driver
DRIVER_KEY2co-driver key


D_INPUT_1Digital Input 1 Value0 = off 1 = on
D_INPUT_2Digital Input 2 Value0 = off 1 = on
D_INPUT_3Digital Input 3 Value0 = off 1 = on
D_INPUT_4Digital Input 4 Value0 = off 1 = on
D_INPUT_5Digital Input 5 Value0 = off 1 = on
D_INPUT_6Digital Input 6 Value0 = off 1 = on
D_INPUT_TEXTSTATE_1Digital Input 1 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
D_INPUT_TEXTSTATE_2Digital Input 2 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
D_INPUT_TEXTSTATE_3Digital Input 3 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
D_INPUT_TEXTSTATE_4Digital Input 4 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
D_INPUT_TEXTSTATE_5Digital Input 5 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
D_INPUT_TEXTSTATE_6Digital Input 6 TextstateInputname and state separated by "@" Bspw. "Tür@offen", is only filled if the input is active
RTI_IDENTRTI Ident
PRIVFLAGPrivate drive mode0 = off / 1 = on

Additional columns

the following columns are only supplied if an additional parameter is specified:

ParameterColumnDescription
temp

DIGITAL_TEMPERATURE_1
value of digital temperature input 1
DIGITAL_TEMPERATURE_2
value of digital temperature input 2
DIGITAL_TEMPERATURE_3
value of digital temperature input 3
DIGITAL_TEMPERATURE_4
value of digital temperature input 4
DIGITAL_TEMPERATURE_5
value of digital temperature input 5
DIGITAL_TEMPERATURE_6
value of digital temperature input 6
DIGITAL_TEMPERATURE_7
value of digital temperature input 7
DIGITAL_TEMPERATURE_8
value of digital temperature input 8
DIGITAL_TEMPERATURE_1_SET_POINT
set point of digital temperature input 1
DIGITAL_TEMPERATURE_2_SET_POINT
set point of digital temperature input 2
DIGITAL_TEMPERATURE_3_SET_POINT
set point of digital temperature input 3
DIGITAL_TEMPERATURE_4_SET_POINT
set point of digital temperature input 4
DIGITAL_TEMPERATURE_5_SET_POINT
set point of digital temperature input 5
DIGITAL_TEMPERATURE_6_SET_POINT
set point of digital temperature input 6
DIGITAL_TEMPERATURE_7_SET_POINT
set point of digital temperature input 7
DIGITAL_TEMPERATURE_8_SET_POINT
set point of digital temperature input 8
ANALOGUE_TEMPERATURE_1
value of analogue temperature input 1
ANALOGUE_TEMPERATURE_2
value of analogue temperature input 2
ANALOGUE_TEMPERATURE_3
value of analogue temperature input 3
ANALOGUE_TEMPERATURE_4
value of analogue temperature input 4

Example

Code Block
titlereturn position
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"DRIVER_KEY";"ETA_TIME";"ETA_DIST";"ETA_DUR";"ETA_LAT";"ETA_LON";"ETA_DESC";"BSZ1";"BSZ2";"DRIVER2";"DRIVER_KEY2";"D_INPUT_1";"D_INPUT_2";"D_INPUT_3";"D_INPUT_4";"D_INPUT_5";"D_INPUT_6";"D_INPUT_TEXTSTATE_1";"D_INPUT_TEXTSTATE_2";"D_INPUT_TEXTSTATE_3";"D_INPUT_TEXTSTATE_4";"D_INPUT_TEXTSTATE_5";"D_INPUT_TEXTSTATE_6";"RTI_IDENT";"PRIVFLAG"
"353234024326181";"2015-04-15 08:52:42";"51.03669";"13.59925";"D-01723 Wilsdruff Am Wüsteberg 3";"207";"10";"0";"0";"Nachrichtstatus aktualisiert";"52469";"2015-04-15 08:52:57";"2015-04-15 06:52:42";"Herr Mueller";"YellowFox GmbH";"123456";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller";"1234";"";"DF1234567890";"John Who";"0";"0";"1";"0";"0";"1";"Temp Innen@aus";"Temp Aussen@aus";"";"Pumpe@offen";"";"Hydraulik@up";"Ident1";"1"

XML Format

Code Block
titlereturn position xml
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yfrtiout-1.4.dtd">
<yfrtiout>
   <message>
      <vehsign>353234024326181</vehsign>
      <date>2015-04-15 08:52:42</date>
      <lat>51.03669</lat>
      <lon>13.59925</lon>
      <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos>
      <dir>207</dir>
      <sat>10</sat>
      <speed>0</speed>
      <ign>0</ign>
      <reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <insertdate>2015-04-15 08:52:57</insertdate>
      <utcdate>2015-04-15 06:52:42</utcdate>
      <driver>Herr Mueller</driver>
      <customer>YellowFox GmbH</customer>
	  <driverkey>123456</driverkey>
	  <eta_time>2015-04-15 09:52:42</eta_time>
	  <eta_dist>12.33</eta_dist>
	  <eta_dur>3600</eta_dur>
	  <eta_lat>50.862247</eta_lat>
	  <eta_lon>12.908245</eta_lon>
	  <eta_desc>Kunde Mueller</eta_desc>
      <bsz1>1234</bsz1>
      <bsz2></bsz2>
      <driver2>John Who</driver2>
	  <driverkey2>DF1234567890</driverkey2>
	  <digital_inputs>
		<d_in>
			<d_nr>1</d_nr>
			<d_name>Temp Innen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>2</d_nr>
			<d_name>Temp Aussen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>4</d_nr>
			<d_name>Pumpe</d_name>
			<d_state>offen</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>6</d_nr>
			<d_name>Hydraulik</d_name>
			<d_state>up</d_state>
			<d_value>1</d_value>
		</d_in>
	</digital_inputs>
	<rti_ident>Ident1</rti_ident>
 	<privflag>1</privflag>
	<digital_temperature_values>
		<d_temp>
			<nr>1</nr>
			<value>10.5</value>
			<set_point>11</set_point>
		</d_temp>
	</digital_temperature_values>
	<analogue_temperature_values>
		<a_temp>
			<nr>1</nr>
			<value>-5</value>
		</a_temp>
	</analogue_temperature_values>
</yfrtiout>

JSON Format (RFC 4627)

Code Block
titlereturn position json
[
    {
        "vehsign": "353234024326181",
        "date": "2016-05-23 08:13:24",
        "lat": "51.0365",
        "lon": "13.5997",
        "pos": "D-01723 Wilsdruff (Kesselsdorf) Am Wüsteberg 3",
        "dir": "40",
        "sat": "14",
        "speed": "0",
        "ign": "0",
        "reason": "Telemetriemeldung",
        "km": "49929",
        "insertdate": "2016-05-23 08:13:41",
        "utcdate": "2016-05-23 06:13:24",
        "driver": "Herr Mueller",
        "customer": "Kunde Mueller",
        "driverkey": "12345",
        "eta_time": "2015-04-15 09:52:42",
        "eta_dist": "2015-04-15 09:52:42",
        "eta_dur": "3600",
        "eta_lat": "50.862247",
        "eta_lon": "12.908245",
        "eta_desc": "Kunde Mueller",
        "bsz1": "1234",
        "bsz2": "",
        "driver2": "John Who",
        "driverkey2": "DF1234567890",
        "digital_inputs": [
            {
                "nr": 1,
                "name": "Temp Innen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 2,
                "name": "Temp Aussen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 4,
                "name": "Pumpe",
                "state": "offen",
                "value": "0"
            },
            {
                "nr": 6,
                "name": "Hydraulik",
                "state": "up",
                "value": "1"
            }
        ],
		"rti_ident": "Ident1",
		"privflag": "1",
	   	"digital_temperature_values": [
			{
				"nr": 1,
				"value": 10.5,
				"set_point": 11
			}
		],
		"analogue_temperature_values": [
			{
				"nr": 1,
				"value": -5
			}
		]
    }
]

Example calls

Code Block
titlecurrent position of one vehicle
https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}


Code Block
titleposition of a car at a defined time range in xml format
https
Sv translation
languageen

Returns position data for the requested vehicle or vehicle group.

Description

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

Parameter

ParameterDescriptionTypeNoteMandatory
companyRTI company keystring yes
vehicleRTI vehcile keystringvehicle or group parameter(yes)
groupRTI group keystringvehicle or group parameter(yes)
startbegin of requested timerangedatestring

Format: YYYYMMDDHHMMSS

Date when the message was processed in the data center (insertdate)

no

endend of requested timerangedatestring

Format: YYYYMMDDHHMMSS

Date when the message was processed in the data center (insertdate)

no
formatreturn formatstringcsv (default) or xmlno

Return

Return a string. In case of error it returns "ERROR:Description".

CSV Format

Meta informations

SeparatorSemicolon ( ; )
DelimiterDouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
HeaderLine 1

Columns

ColumnDescription 
VEHICLEvehicle licence 
DATEGPS date of message creationFormat: YYYY-MM-DD HH:MM:SS
LATLatitudeExample.: 51.03659
LONLongitudeExample.: 13.59967
POSadress text 
DIRdirection in grade0=North, 90=East
SATAnzahl Satelliten 
SPEEDspeed in full km/h 
IGNignition state0 = off, 1 = on
REASONreason of the message 
KModometer value in full km 
INSERTDATEDate when the message was processed in the data centerFormat: YYYY-MM-DD HH:MM:SS
UTCDATEUTC date of message creationFormat: YYYY-MM-DD HH:MM:SS
DRIVERname of logged in driver 
CUSTOMERcustomer namein case of a possible customer position allocation
DRIVER_KEYdriver key 
ETA_TIMEestimated time of arrival at navigation targetFormat: YYYY-MM-DD HH:MM:SS
ETA_DISTestimated time of arrival at navigation target in kilometer 
ETA_DURestimated duration of arrival at navigation target in seconds 
ETA_LATLatitute coordinate of navigation targetBsp.: 51.03659
ETA_LONLongitude coordinate of navigation targetBsp.: 13.59967
ETA_DESCcustomer allocation of navigation targetin case of a possible customer position allocation
BSZ1operation time counter 1value in full minutes
BSZ2operation time counter 2value in full minutes

Example

Code Block
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"DRIVER_KEY";"ETA_TIME";"ETA_DIST";"ETA_DUR";"ETA_LAT";"ETA_LON";"ETA_DESC";"BSZ1";"BSZ2"
"353234024326181";"2015-04-15 08:52:42";"51.03669";"13.59925";"D-01723 Wilsdruff Am Wüsteberg 3";"207";"10";"0";"0";"Nachrichtstatus aktualisiert";"52469";"2015-04-15 08:52:57";"2015-04-15 06:52:42";"Herr Mueller";"YellowFox GmbH";"123456";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller";"1234";""

XML Format

Code Block
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "http://map.yellowfox.de/rti/dtd/yfrtiout-1.3.dtd">
<yfrtiout>
   <message>
      <vehsign>353234024326181</vehsign>
      <date>2015-04-15 08:52:42</date>
      <lat>51.03669</lat>
      <lon>13.59925</lon>
      <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos>
      <dir>207</dir>
      <sat>10</sat>
      <speed>0</speed>
      <ign>0</ign>
      <reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <insertdate>2015-04-15 08:52:57</insertdate>
      <utcdate>2015-04-15 06:52:42</utcdate>
      <driver>Herr Mueller</driver>
      <customer>YellowFox GmbH</customer>
      <driverkey>123456</driverkey>
	  <eta_time>2015-04-15 09:52:42</eta_time>
	  <eta_dist>12.33</eta_dist>
	  <eta_dur>3600</eta_dur>
	  <eta_lat>50.862247</eta_lat>
	  <eta_lon>12.908245</eta_lon>
	  <eta_desc>Kunde Mueller</eta_desc>
      <bsz1>1234</bsz1>
      <bsz2></bsz2>
   </message>
</yfrtiout>

Example Calls

Code Block
titlecurrent position of one vehicle
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
Code Block
titleposition of a car at a defined time range in xml format
http&start=20150401000000&end=20150401235959&format=xml

https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY{"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20150401000000&end=20150401235959&format=xml