do_track_once.php One time detection for a vehicle or group. Description do_track_once.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=xml
Parameter| Parameter | Description | Typ | Note | Mandatory |
|---|
| company | RTI company key | string |
| yes | | vehicle | RTI vehicle key | string | either vehicle or group parameter | (yes) | | group | RTI group key | string | either vehicle or group parameter | (yes) | | format | format of the result | string | format of the result from the interface supported formats: csv (default) | no |
ReturnBy default, a CSV string is returned, which contains OK for each vehicle on success. If an error occurs, an "ERROR:Description" is returned.
| Seperator | Semicolon ( ; ) |
|---|
| Delimter | Double quote ( " ) |
|---|
| Line Break | 0x0D 0x0A (CarriageReturn LineFeed) |
|---|
| Header | Line 1 |
|---|
Columns| Column | Description |
|---|
| CAR | vehicle name | | RESULT | result of the action |
Example| Code Block |
|---|
| title | Result format as CSV |
|---|
| "CAR";"RESULT"
"Car 1";"OK"
"Car 2";"OK"
"Car 3";"ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION"
"Car 4";"ERROR_SEND_ONE_TIME_DETECTION" |
| Code Block |
|---|
| language | xml |
|---|
| title | Result format as XML |
|---|
| <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE yf_dotrackonce SYSTEM "http://map.yellowfox.de/rti/dtd/yf_dotrackonce.dtd">
<yf_dotrackonce>
<tracking>
<car>Car 1</car>
<result>OK</result>
</tracking>
<tracking>
<car>Car 2</car>
<result>OK</result>
</tracking>
<tracking>
<car>Car 3</car>
<result>ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION</result>
</tracking>
<tracking>
<car>Car 4</car>
<result>ERROR_SEND_ONE_TIME_DETECTION</result>
</tracking>
</yf_dotrackonce> |
| Code Block |
|---|
| title | Result format as JSON |
|---|
| [{"car":"Car 1","result":"OK"},{"car":"Car 2","result":"OK"},{"car":"Car 3","result":"ERROR_VEHICLE_NOT_SUPPORTED_ONE_TIME_DETECTION"},{"car":"Car 4","result":"ERROR_SEND_ONE_TIME_DETECTION"}] |
Example calls
| Code Block |
|---|
| title | One time detection for a single vehicle |
|---|
| https://map.yellowfox.de/rti/do_track_once.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
https://map.yellowfox.de/rti/do_track_once.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"} |
| Code Block |
|---|
| title | One time detection for a group with desired return format as XML |
|---|
| https://map.yellowfox.de/rti/do_track_once.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&format=xml |
|