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
Parameter | Description | Type | Note | Mandatory |
---|---|---|---|---|
company | RTI company key | string | yes | |
vehicle | RTI vehcile key | string | vehicle or group parameter | (yes) |
group | RTI group key | string | vehicle or group parameter | (yes) |
start | begin of requested timerange | datestring | Format: YYYYMMDDHHMMSS Date when the message was processed in the data center (insertdate) | no |
end | end of requested timerange | datestring | Format: YYYYMMDDHHMMSS Date when the message was processed in the data center (insertdate) | no |
format | return format | string | csv (default) or xml | no |
Return
Return a string. In case of error it returns "ERROR:Description".
CSV Format
Meta informations
Separator | Semicolon ( ; ) |
---|---|
Delimiter | Double quote ( " ) |
Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
Header | Line 1 |
Columns
Column | Description | |
---|---|---|
VEHICLE | vehicle licence | |
DATE | GPS date of message creation | Format: YYYY-MM-DD HH:MM:SS |
LAT | Latitude | Example.: 51.03659 |
LON | Longitude | Example.: 13.59967 |
POS | adress text | |
DIR | direction in grade | 0=North, 90=East |
SAT | Anzahl Satelliten | |
SPEED | speed in full km/h | |
IGN | ignition state | 0 = off, 1 = on |
REASON | reason of the message | |
KM | odometer value in full km | |
INSERTDATE | Date when the message was processed in the data center | Format: YYYY-MM-DD HH:MM:SS |
UTCDATE | UTC date of message creation | Format: YYYY-MM-DD HH:MM:SS |
DRIVER | name of logged in driver | |
CUSTOMER | customer name | in case of a possible customer position allocation |
DRIVER_KEY | driver key | |
ETA_TIME | estimated time of arrival at navigation target | Format: YYYY-MM-DD HH:MM:SS |
ETA_DIST | estimated time of arrival at navigation target in kilometer | |
ETA_DUR | estimated duration of arrival at navigation target in seconds | |
ETA_LAT | Latitute coordinate of navigation target | Bsp.: 51.03659 |
ETA_LON | Longitude coordinate of navigation target | Bsp.: 13.59967 |
ETA_DESC | customer allocation of navigation target | in case of a possible customer position allocation |
BSZ1 | operation time counter 1 | value in full minutes |
BSZ2 | operation time counter 2 | value in full minutes |
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" "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
<?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>
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":""}]
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