You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 32 Next »

Returns position data for the requested vehicle or vehicle group.

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

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

Example

"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";"";"John Who";"DF1234567890";"John Who";"0";"0";"1";"0";"0";"1";"Temp Innen@aus";"Temp Aussen@aus";"";"Pumpe@offen";"";"Hydraulik@up"

XML Format

<?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>
      <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)

[{"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"}}]

Example Calls

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

 


  • No labels