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| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|
| company | RTI Firmenschlüssel | string |
| ja | | vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group Parameter | (ja) | | group | RTI Gruppenschlüssel | string | entweder vehicle oder group Parameter | (ja) | | start | Anfang des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS | nein | | end | Ende des Abfragezeitraum | datestring | Format: YYYYMMDDHHMMSS | nein | | query_date | Datum zu welchen Zeitpunkt die jeweilige Position angezeigt werden soll | datestring | Format: YYYYMMDDHHMMSS | nein | | format | Rückgabeformat | string | csv (Standard) xml, json | nein | | date_query | Welches Datum bildet die Grundlage für die Zeitraumeingrenzung | string | 'insert' (Standard) = Verarbeitungsdatum 'gps' = Datum an dem die Positionsmeldung stattgefunden hat | nein | | additionaldata | Zusä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-4 | nein | | hide_display | Blendet Meldungen vom Display aus | int | - 0 (Standard) = Displaymeldungen werden mit ausgegeben
- 1 = Displaymeldungen werden nicht mit ausgegeben
| nein |
RückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben. | Trennzeichen | Semikolon ( ; ) |
|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
|---|
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
|---|
| Header | Zeile 1 |
|---|
Spalten
| Spalte | Beschreibung |
|
|---|
| 1 | VEHICLE | Fahrzeugkennzeichen |
| | 2 | DATE | GPS Datum wann die Meldung erzeugt wurde | Format: YYYY-MM-DD HH:MM:SS | | 3 | LAT | Latitude | Bsp.: 51.03659 | | 4 | LON | Longitude | Bsp.: 13.59967 | | 5 | POS | Adresse |
| | 6 | DIR | Richtung in ganzen Grad | 0=Nord, 90=Ost | | 7 | SAT | Anzahl Satelliten |
| | 8 | SPEED | Geschwindigkeit in ganzen km/h |
| | 9 | IGN | Zündungsstatus | 0 = Aus, 1 = An, null = undefiniert | | 10 | REASON | Grund der Meldung |
| | 11 | KM | Kilometerstand in ganzen km |
| | 12 | INSERTDATE | Datum wann die Meldung im Rechenzentrum verarbeitet wurde | Format: YYYY-MM-DD HH:MM:SS | | 13 | UTCDATE | UTC Datum wann die Meldung erzeugt wurde | Format: YYYY-MM-DD HH:MM:SS | | 14 | DRIVER | Name des angemeldeten Fahrer |
| | 15 | CUSTOMER | Kundenname | falls sich die Position einer Kundenadresse zuordnen lässt | | 16 | DRIVER_KEY | Fahrerschlüssel |
| | 17 | ETA_TIME | Erwartete Ankunftszeit am Navigationsziel | Format: YYYY-MM-DD HH:MM:SS | | 18 | ETA_DIST | Erwartete Distanz bis zum Navigationsziel in Kilometer |
| | 19 | ETA_DUR | Erwartete Dauer bis zum Navigationsziel in Sekunden |
| | 20 | ETA_LAT | Latitute Koordinate des Navigationsziels | Bsp.: 51.03659 | | 21 | ETA_LON | Longitude Koordinate des Navigationsziels | Bsp.: 13.59967 | | 22 | ETA_DESC | Kundenadresszuordnung des Navigationsziels | falls sich die Position einer Kundenadresse zuordnen lässt | | 23 | BSZ1 | Betriebsstundenzähler 1 | Wert in ganzen Minuten | | 24 | BSZ2 | Betriebsstundenzähler 2 | Wert in ganzen Minuten | | 25 | DRIVER2 | Name des angemeldeten Beifahrers |
| | 26 | DRIVER_KEY2 | Fahrerschlüssel vom Beifahrer |
| | 27 | D_INPUT_1 | Digitaler Eingang 1 Wert | 0 = aus 1 = an | | 28 | D_INPUT_2 | Digitaler Eingang 2 Wert | 0 = aus 1 = an | | 29 | D_INPUT_3 | Digitaler Eingang 3 Wert | 0 = aus 1 = an | | 30 | D_INPUT_4 | Digitaler Eingang 4 Wert | 0 = aus 1 = an | | 31 | D_INPUT_5 | Digitaler Eingang 5 Wert | 0 = aus 1 = an | | 32 | D_INPUT_6 | Digitaler Eingang 6 Wert | 0 = aus 1 = an | | 33 | D_INPUT_TEXTSTATE_1 | Digitaler Eingang 1 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 34 | D_INPUT_TEXTSTATE_2 | Digitaler Eingang 2 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 35 | D_INPUT_TEXTSTATE_3 | Digitaler Eingang 3 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 36 | D_INPUT_TEXTSTATE_4 | Digitaler Eingang 4 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 37 | D_INPUT_TEXTSTATE_5 | Digitaler Eingang 5 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 38 | D_INPUT_TEXTSTATE_6 | Digitaler Eingang 6 Textstatus | Eingangsname und Status getrennt mit einem "@" Bspw. "Tür@offen", ist nur befüllt, falls der Eingang aktiv ist | | 39 | RTI_IDENT | RTI Ident des Fahrzeuges |
| | 40 | PRIVFLAG | Privatfahrt Status | 0 = aus / 1 = an |
ZusatzspaltenDie folgenden Spalten werden ausschließlich bei Angabe eines Zusatzparameters mit ausgeliefert: | Parameter | Spalte | Beschreibung |
|---|
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";"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";"PRIVFLAG"
"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",;"1"
|
| Code Block |
|---|
| title | Positions-Rückgabe XML |
|---|
| <?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE yfrtiout SYSTEM "https://map.yellowfox.de/rti/dtd/yfrtiout-1.4.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>
<driver2>John Who</driver2>
<driverkey2>DF1234567890</driverkey2>
<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>4</d_nr>
<d_name>Pumpe</d_name>
<d_state>offen</d_state>
<d_value>0</d_value>
</d_in>
<d_in>
<d_nr>6</d_nr>
<d_name>Hydraulik</d_name>
<d_state>up</d_state>
<d_value>1</d_value>
</d_in>
</digital_inputs>
<rti_ident>Ident1</rti_ident>
<privflag>1</privflag>
<digital_temperature_values>
<d_temp>
<nr>1</nr>
<value>10.5</value>
<set_point>11</set_point>
</d_temp>
</digital_temperature_values>
<analogue_temperature_values>
<a_temp>
<nr>1</nr>
<value>-5</value>
</a_temp>
</analogue_temperature_values>
</yfrtiout> |
| Code Block |
|---|
| title | Positions-Rückgabe JSON |
|---|
| [
{
"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",
"value": "1"
}
],
"rti_ident": "Ident1",
"privflag": "1",
"digital_temperature_values": [
{
"nr": 1,
"value": 10.5,
"set_point": 11
}
],
"analogue_temperature_values": [
{
"nr": 1,
"value": -5
}
]
}
] |
Beispielaufrufe| Code Block |
|---|
| title | Aktuelle Position eines Fahrzeuges im CSV Format |
|---|
| https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY
https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"} |
| Code Block |
|---|
| title | Positionen eines Fahrzeuges in einem bestimmten Zeitraum im XML Format |
|---|
| https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=20150401000000&end=20150401235959&format=xml
https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20150401000000&end=20150401235959&format=xml |
|