Versions Compared

Old Version 14

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 15

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Veranlasst einmalige Ortung für ein Fahrzeug oder eine Gruppe

Beschreibung

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

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring

ja

vehicleRTI Fahrzeugschlüsselstringentweder vehicle oder group werden erwartet(ja)
groupRTI Gruppenschlüsselstringentweder vehicle oder group werden erwartet(ja)
formatRückgabeformatstringFormat der zurückgelieferten Antwort der Schnittstelle

unterstüzte Formate: csv (Standard), xml, json

nein

Rückgabe

Es wird standardmäßig ein CSV-String zurückgegeben, welcher zu jedem Fahrzeug bei Erfolg OK enthält. Bei einem Fehler wird ein "ERROR:Beschreibung" zurückgegeben

CSV-Format

Metainformationen

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Spalten

SpalteBeschreibung
CARVehicle-Name
RESULTResultat der Aktion

Beispiel

Code Block
titleRückgabe als 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

Code Block
languagexml
titleRückgabe als 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)

Code Block
titleRückgabe als 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"}]

Beispielaufrufe

Code Block
titleEinmalige Ortung eines einzelnen Fahrzeuges
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
titleEinmalige Ortung einer Gruppe und gewünschten Rückgabeformat als XML
https://map.yellowfox.de/rti/do_track_once.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&format=xml


...