Versions Compared

Old Version 19

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 20

changes.mady.by.user YellowFox R&D

Saved on

Key

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

Gibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.

Beschreibung

get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring ja
vehicleRTI Fahrzeugschlüsselstringentweder vehicle oder group Parameter(ja)
groupRTI Gruppenschlüsselstringentweder vehicle oder group Parameter(ja)
startAnfang des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

es wird das Datum der Meldungsverarbeitung(insertdate) verwendet

nein

endEnde des Abfragezeitraumdatestring

Format: YYYYMMDDHHMMSS

es wird das Datum der Meldungsverarbeitung(insertdate) verwendet

nein
formatRückgabeformatstringcsv (Standard) xml, jsonnein

Rückgabe

Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

CSV Format

Metainformationen

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

Spalten

SpalteBeschreibung 
VEHICLEFahrzeugkennzeichen 
DATEGPS Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
LATLatitudeBsp.: 51.03659
LONLongitudeBsp.: 13.59967
POSAdresse 
DIRRichtung in ganzen Grad0=Nord, 90=Ost
SATAnzahl Satelliten 
SPEEDGeschwindigkeit in ganzen km/h 
IGNZündungsstatus0 = Aus, 1 = An
REASONGrund der Meldung 
KMKilometerstand in ganzen km 
INSERTDATEDatum wann die Meldung im Rechenzentrum verarbeitet wurdeFormat: YYYY-MM-DD HH:MM:SS
UTCDATEUTC Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
DRIVERName des angemeldeten Fahrer 
CUSTOMERKundennamefalls sich die Position einer Kundenadresse zuordnen lässt
DRIVER_KEYFahrerschlüssel 
ETA_TIMEErwartete Ankunftszeit am NavigationszielFormat: YYYY-MM-DD HH:MM:SS
ETA_DISTErwartete Distanz bis zum Navigationsziel in Kilometer 
ETA_DURErwartete Dauer bis zum Navigationsziel in Sekunden 
ETA_LATLatitute Koordinate des NavigationszielsBsp.: 51.03659
ETA_LONLongitude Koordinate des NavigationszielsBsp.: 13.59967
ETA_DESCKundenadresszuordnung des Navigationszielsfalls sich die Position einer Kundenadresse zuordnen lässt
BSZ1Betriebsstundenzähler 1Wert in ganzen Minuten
BSZ2Betriebsstundenzähler 2Wert in ganzen Minuten

Beispiel

Code Block
"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

Code Block
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "http://map.yellowfox.de/rti/dtd/yfrtiout-1.2.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)

Code Block
[{"vehsign":"A9 Peter Stimpel","date":"2016-05-23 
08:13:24","lat":"51.0365","lon":"13.5997","pos":null,"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":"YellowFoxKunde 
GmbHMueller","driverkey":"12345","eta_time":null,"eta_dist":null"2015-04-15 09:52:42","eta_dur":null"3600","eta_lat":null"50.862247","eta_lon":null"12.908245","eta_desc":"Kunde Mueller","bsz1":"1234","bsz2":""}]

 Beispielaufrufe

Code Block
titleAktuelle Position eines Fahrzeuges im CSV Format
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
Code Block
titlePositionen eines Fahrzeuges in einem bestimmten Zeitraum im XML Format
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml

 

 

...