Sv translation

language	de

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

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

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
company	RTI Firmenschlüssel	string		ja
vehicle	RTI Fahrzeugschlüssel	string	entweder vehicle oder group Parameter	(ja)
group	RTI Gruppenschlüssel	string	entweder vehicle oder group Parameter	(ja)
start	Anfang des Abfragezeitraum	datestring	Format: YYYYMMDDHHMMSS es wird das Datum der Meldungsverarbeitung(insertdate) verwendet	nein
end	Ende des Abfragezeitraum	datestring	Format: YYYYMMDDHHMMSS es wird das Datum der Meldungsverarbeitung(insertdate) verwendet	nein
format	Rückgabeformat	string	csv (Standard) xml, json	nein

Rückgabe

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

CSV Format

Metainformationen

Trennzeichen	Semikolon ( ; )
Textbegrenzer	Doppeltes Hochkomma ( " )
Zeilenende	0x0D 0x0A (CarriageReturn LineFeed)
Header	Zeile 1

Spalten

Spalte	Beschreibung
VEHICLE	Fahrzeugkennzeichen
DATE	GPS Datum wann die Meldung erzeugt wurde	Format: YYYY-MM-DD HH:MM:SS
LAT	Latitude	Bsp.: 51.03659
LON	Longitude	Bsp.: 13.59967
POS	Adresse
DIR	Richtung in ganzen Grad	0=Nord, 90=Ost
SAT	Anzahl Satelliten
SPEED	Geschwindigkeit in ganzen km/h
IGN	Zündungsstatus	0 = Aus, 1 = An
REASON	Grund der Meldung
KM	Kilometerstand in ganzen km
INSERTDATE	Datum wann die Meldung im Rechenzentrum verarbeitet wurde	Format: YYYY-MM-DD HH:MM:SS
UTCDATE	UTC Datum wann die Meldung erzeugt wurde	Format: YYYY-MM-DD HH:MM:SS
DRIVER	Name des angemeldeten Fahrer
CUSTOMER	Kundenname	falls sich die Position einer Kundenadresse zuordnen lässt
DRIVER_KEY	Fahrerschlüssel
ETA_TIME	Erwartete Ankunftszeit am Navigationsziel	Format: YYYY-MM-DD HH:MM:SS
ETA_DIST	Erwartete Distanz bis zum Navigationsziel in Kilometer
ETA_DUR	Erwartete Dauer bis zum Navigationsziel in Sekunden
ETA_LAT	Latitute Koordinate des Navigationsziels	Bsp.: 51.03659
ETA_LON	Longitude Koordinate des Navigationsziels	Bsp.: 13.59967
ETA_DESC	Kundenadresszuordnung des Navigationsziels	falls sich die Position einer Kundenadresse zuordnen lässt
BSZ1	Betriebsstundenzähler 1	Wert in ganzen Minuten
BSZ2	Betriebsstundenzähler 2	Wert in ganzen Minuten
DRIVER2	Name des angemeldeten Beifahrers
DRIVER_KEY2	Fahrerschlüssel vom Beifahrer

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";"DRIVER2";"DRIVER_KEY2"
"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"

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>
      <driver2>John Who</driver2>
	  <driverkey2>DF1234567890</driverkey2>
   </message>
</yfrtiout>

JSON Format (RFC 4627)

D_INPUT_1	Digitaler Eingang 1 Wert	0 = aus 1 = an
D_INPUT_2	Digitaler Eingang 2 Wert	0 = aus 1 = an
D_INPUT_3	Digitaler Eingang 3 Wert	0 = aus 1 = an
D_INPUT_4	Digitaler Eingang 4 Wert	0 = aus 1 = an
D_INPUT_5	Digitaler Eingang 5 Wert	0 = aus 1 = an
D_INPUT_6	Digitaler Eingang 6 Wert	0 = aus 1 = an
D_INPUT_TEXTSTATE_1	Digitaler Eingang 1 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
D_INPUT_TEXTSTATE_2	Digitaler Eingang 2 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
D_INPUT_TEXTSTATE_3	Digitaler Eingang 3 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
D_INPUT_TEXTSTATE_4	Digitaler Eingang 4 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
D_INPUT_TEXTSTATE_5	Digitaler Eingang 5 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
D_INPUT_TEXTSTATE_6	Digitaler Eingang 6 Textstatus	Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist

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";"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"
"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"

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.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>
</yfrtiout>

JSON Format (RFC 4627)

Code Block

[{"vehsign":"353234024326181","date":"2016-05-23 08:13:24","lat":"51.0365","lon":"13.5997","pos":"D-01723 Wilsdruff (Kesselsdorf) Am W\u00fcsteberg 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"}]}

Code Block

[{"vehsign":"353234024326181","date":"2016-05-23 08:13:24","lat":"51.0365","lon":"13.5997","pos":"D-01723 Wilsdruff (Kesselsdorf) Am W\u00fcsteberg 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"}]

Beispielaufrufe

Code Block

title	Aktuelle Position eines Fahrzeuges im CSV Format

http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

Code Block

title	Positionen 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

...

Page tree

Versions Compared

Old Version 28

New Version 29

Key

Beschreibung

Parameter

Rückgabe

CSV Format

Metainformationen

Spalten

Beispiel

XML Format

JSON Format (RFC 4627)

Beispiel

XML Format

JSON Format (RFC 4627)

Beispielaufrufe

Page tree

Page History

Versions Compared

Old Version 28

New Version 29

Key

Beschreibung

Parameter

Rückgabe

CSV Format

Metainformationen

Spalten

Beispiel

XML Format

JSON Format (RFC 4627)

Beispiel

XML Format

JSON Format (RFC 4627)

Beispielaufrufe