Returns position data for the requested vehicle or vehicle group. Descriptionget_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMM&end=YYYYMMDDHHMM&format=csv ParameterParameter | 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 |
ReturnReturn a string. In case of error it returns "ERROR_description". Separator | Semicolon ( ; ) |
---|
Delimiter | Double quote ( " ) |
---|
Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Line 1 |
---|
ColumnsColumn | 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 | 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 Code Block |
---|
"VEHICLE";"DATE";"LAT";"LON";"POS";"DIR";"SAT";"SPEED";"IGN";"REASON";"KM";"INSERTDATE";"UTCDATE";"DRIVER";"CUSTOMER";"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";"2015-04-15 09:52:42";"12.33";"3600";"50.862247";"12.908245";"Kunde Mueller";"1234";"" |
Code Block |
---|
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "http://map.yellowfox.de/rti/dtd/yfrtiout-1.23.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>
<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 |
---|
title | current position of one vehicle |
---|
| http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY |
Code Block |
---|
title | 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 |
|