Versions Compared

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.

Wird keine Zeitraumbegrenzung (start und end) mitgegeben, wird die jeweilig aktuelle Position zurückgeliefert.

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
date_queryWelches Datum bildet die Grundlage für die Zeitraumeingrenzungstring

'insert' (Standard) = Verarbeitungsdatum

'gps' = Datum an dem die Positionsmeldung stattgefunden hat

nein
additionaldataZusätzliche Parameter um bestimmte Informationen zusätzlich zu erhalten, per Komma getrennt string'temp' holt die Temperaturwerte der Digitalen Sensoren 1-8 und Analogen Sensoren 1-4nein

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
1VEHICLEFahrzeugkennzeichen
2DATEGPS Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
3LATLatitudeBsp.: 51.03659
4LONLongitudeBsp.: 13.59967
5POSAdresse
6DIRRichtung in ganzen Grad0=Nord, 90=Ost
7SATAnzahl Satelliten
8SPEEDGeschwindigkeit in ganzen km/h
9IGNZündungsstatus0 = Aus, 1 = An, null = undefiniert
10REASONGrund der Meldung
11KMKilometerstand in ganzen km
12INSERTDATEDatum wann die Meldung im Rechenzentrum verarbeitet wurdeFormat: YYYY-MM-DD HH:MM:SS
13UTCDATEUTC Datum wann die Meldung erzeugt wurdeFormat: YYYY-MM-DD HH:MM:SS
14DRIVERName des angemeldeten Fahrer
15CUSTOMERKundennamefalls sich die Position einer Kundenadresse zuordnen lässt
16DRIVER_KEYFahrerschlüssel
17ETA_TIMEErwartete Ankunftszeit am NavigationszielFormat: YYYY-MM-DD HH:MM:SS
18ETA_DISTErwartete Distanz bis zum Navigationsziel in Kilometer
19ETA_DURErwartete Dauer bis zum Navigationsziel in Sekunden
20ETA_LATLatitute Koordinate des NavigationszielsBsp.: 51.03659
21ETA_LONLongitude Koordinate des NavigationszielsBsp.: 13.59967
22ETA_DESCKundenadresszuordnung des Navigationszielsfalls sich die Position einer Kundenadresse zuordnen lässt
23BSZ1Betriebsstundenzähler 1Wert in ganzen Minuten
24BSZ2Betriebsstundenzähler 2Wert in ganzen Minuten
25DRIVER2Name des angemeldeten Beifahrers
26DRIVER_KEY2Fahrerschlüssel vom Beifahrer
27D_INPUT_1Digitaler Eingang 1 Wert0 = aus 1 = an
28D_INPUT_2Digitaler Eingang 2 Wert0 = aus 1 = an
29D_INPUT_3Digitaler Eingang 3 Wert0 = aus 1 = an
30D_INPUT_4Digitaler Eingang 4 Wert0 = aus 1 = an
31D_INPUT_5Digitaler Eingang 5 Wert0 = aus 1 = an
32D_INPUT_6Digitaler Eingang 6 Wert0 = aus 1 = an
33D_INPUT_TEXTSTATE_1Digitaler Eingang 1 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
34D_INPUT_TEXTSTATE_2Digitaler Eingang 2 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
35D_INPUT_TEXTSTATE_3Digitaler Eingang 3 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
36D_INPUT_TEXTSTATE_4Digitaler Eingang 4 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
37D_INPUT_TEXTSTATE_5Digitaler Eingang 5 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
38D_INPUT_TEXTSTATE_6Digitaler Eingang 6 TextstatusEingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist
39RTI_IDENTRTI Ident des Fahrzeuges

Beispiel


Zusatzspalten

Die folgenden Spalten werden ausschließlich bei Angabe eines Zusatzparameters mit ausgeliefert:

ParameterSpalteBeschreibung
temp

DIGITAL_TEMPERATURE_1
Wert des digitalen Eingangs 1
DIGITAL_TEMPERATURE_2
Wert des digitalen Eingangs 2
DIGITAL_TEMPERATURE_3
Wert des digitalen Eingangs 3
DIGITAL_TEMPERATURE_4
Wert des digitalen Eingangs 4
DIGITAL_TEMPERATURE_5
Wert des digitalen Eingangs 5
DIGITAL_TEMPERATURE_6
Wert des digitalen Eingangs 6
DIGITAL_TEMPERATURE_7
Wert des digitalen Eingangs 7
DIGITAL_TEMPERATURE_8
Wert des digitalen Eingangs 8
DIGITAL_TEMPERATURE_1_SET_POINT
Richtwert des digitalen Eingangs 1
DIGITAL_TEMPERATURE_2_SET_POINT
Richtwert des digitalen Eingangs 2
DIGITAL_TEMPERATURE_3_SET_POINT
Richtwert des digitalen Eingangs 3
DIGITAL_TEMPERATURE_4_SET_POINT
Richtwert des digitalen Eingangs 4
DIGITAL_TEMPERATURE_5_SET_POINT
Richtwert des digitalen Eingangs 5
DIGITAL_TEMPERATURE_6_SET_POINT
Richtwert des digitalen Eingangs 6
DIGITAL_TEMPERATURE_7_SET_POINT
Richtwert des digitalen Eingangs 7
DIGITAL_TEMPERATURE_8_SET_POINT
Richtwert des digitalen Eingangs 8
ANALOGUE_TEMPERATURE_1
Wert des analogen Eingangs 1
ANALOGUE_TEMPERATURE_2
Wert des analogen Eingangs 2
ANALOGUE_TEMPERATURE_3
Wert des analogen Eingangs 3
ANALOGUE_TEMPERATURE_4
Wert des analogen Eingangs 4


Beispiel

Code Block
"VEHICLE";"DATE";"LAT";"LON";"
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";"DRIVER2";"DRIVER_KEY2";"D_INPUT_1";"D_INPUT_2";"D_INPUT_3";"D_INPUT_4";"D_INPUT_5";"D_INPUT_6";"D_INPUT_TEXTSTATE_1";"D_INPUT_TEXTSTATE_2";"D_INPUT_TEXTSTATE_3";"D_INPUT_TEXTSTATE_4";"D_INPUT_TEXTSTATE_5";"D_INPUT_TEXTSTATE_6";"RTI_IDENT"
"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";"";"DF1234567890";"John Who";"0";"0";"1";"0";"0";"1";"Temp Innen@aus";"Temp Aussen@aus";"";"Pumpe@offen";"";"Hydraulik@up";"Ident1"


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.4.dtd">
<yfrtiout>
   <message>
      <vehsign>353234024326181</vehsign>
     <message> <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>
      <vehsign>353234024326181<<dir>207</vehsign>dir>
      <date>2015-04-15 08:52:42</date><sat>10</sat>
      <lat>51.03669<<speed>0</lat>speed>
      <lon>13.59925<<ign>0</lon>ign>
      <pos>D-01723 Wilsdruff Am Wüsteberg 3</pos><reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <dir>207</dir><insertdate>2015-04-15 08:52:57</insertdate>
      <sat>10</sat>
<utcdate>2015-04-15 06:52:42</utcdate>
      <driver>Herr <speed>0<Mueller</speed>driver>
      <customer>YellowFox <ign>0<GmbH</ign>customer>
	  <driverkey>123456</driverkey>
	  <eta_time>2015-04-15  <reason>Nachrichtstatus aktualisiert</reason>
      <km>52469</km>
      <insertdate>2015-04-15 08:52:57</insertdate>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>
      <utcdate>2015-04-15 06:52:42</utcdate><bsz1>1234</bsz1>
      <driver>Herr Mueller<<bsz2></driver>bsz2>
      <driver2>John <customer>YellowFox GmbH<Who</customer>driver2>
	  <driverkey>123456<<driverkey2>DF1234567890</driverkey>driverkey2>
	  <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>
      <driver2>John Who</driver2>
	  <driverkey2>DF1234567890</driverkey2>
	  <digital_inputs><digital_inputs>
		<d_in>
			<d_nr>1</d_nr>
			<d_name>Temp Innen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>2</d_nr>
			<d_name>Temp Aussen</d_name>
			<d_state>aus</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>1<nr>4</d_nr>
			<d_name>Temp Innen<name>Pumpe</d_name>
			<d_state>aus<state>offen</d_state>
			<d_value>0</d_value>
		</d_in>
		<d_in>
			<d_nr>2<nr>6</d_nr>
			<d_name>Temp Aussen<name>Hydraulik</d_name>
			<d_state>aus<state>up</d_state>
			<d_value>0<value>1</d_value>
		</d_in>
	</digital_inputs>
	<digital_temperature_values>
		<d_in>temp>
			<d_nr>4<<nr>1</d_nr>
			<d_name>Pumpe</d_name><value>10.5</value>
			<d<set_state>offen<point>11</dset_state>point>
			<d_value>0<</d_value>temp>
		</d_in>
		<d_in>
			<d_nr>6</d_nr>
			<d_name>Hydraulik</d_name>digital_temperature_values>
	<analogue_temperature_values>
		<a_temp>
			<d_state>up</d_state><nr>1</nr>
			<d_value>1</d_<value>-5</value>
		</da_in>temp>
	</digitalanalogue_temperature_inputs>values>
	<rti_ident>Ident1</rti_ident>
</yfrtiout>

JSON Format (RFC 4627)

Code Block
[
    {
        "vehsign": "353234024326181",
        "date": "2016-05-23 08:13:24",
        "lat": "51.0365",
        "lon": "13.5997",
        "pos": "D-01723 Wilsdruff (Kesselsdorf) Am Wüsteberg 3",
        "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": "Kunde Mueller",
        "driverkey": "12345",
        "eta_time": "2015-04-15 09:52:42",
        "eta_dist": "2015-04-15 09:52:42",
        "eta_dur": "3600",
        "eta_lat": "50.862247",
        "eta_lon": "12.908245",
        "eta_desc": "Kunde Mueller",
        "bsz1": "1234",
        "bsz2": "",
        "driver2": "John Who",
        "driverkey2": "DF1234567890",
        "digital_inputs": [
            {
                "nr": 1,
                "name": "Temp Innen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 2,
                "name": "Temp Aussen",
                "state": "aus",
                "value": "0"
            },
            {
                "nr": 4,
                "name": "Pumpe",
                "state": "offen",
                "value": "0"
            },
            {
                 {"nr": 6,
                "name": "Hydraulik",
                "state": "up",
                "nrvalue": 6,"1"
            }
        "name],
		"digital_temperature_values": "Hydraulik",
                "state": "up",
                "value": "1"
            }
        [
			{
				"nr": 1,
				"value": 10.5,
				"set_point": 11
			}
		],
		"analogue_temperature_values": [
			{
				"nr": 1,
				"value": -5
			}
		],
		"rti_ident": "Ident1"
    }
]

 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



...