Description

do_track_once.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&format=xml

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
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

Return

By default, a CSV string is returned, which contains OK for each vehicle on success. If an error occurs, an "ERROR:Description" is returned.

CSV-Format

Meta informations

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

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"

XML Format

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>

JSON Format (RFC 4627)

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

Examples

One time detection for a single vehicle

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

One time detection for a group with desired return format as XML

http://map.yellowfox.de/rti/do_track_once.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&format=xml

Page tree

do_track_once.php