Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
Parameter
es wird das Datum der Meldungsverarbeitung(insertdate) verwendet
RückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
RückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben. CSV FormatMetainformationen
Spalten
Beispiel
XML Format
ZusatzspaltenDie folgenden Spalten werden ausschließlich bei Angabe eines Zusatzparameters mit ausgeliefert:
Beispiel
XML Format
JSON Format (RFC 4627)
JSON Format (RFC 4627)
Beispielaufrufe
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Beispielaufrufe
|
Sv translation | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Returns position data for the requested vehicle or vehicle group. If no start and end are given, current position will be returned. Description
Parameter
ReturnReturn a string. In case of error it returns "ERROR:Description". CSV FormatMeta informations
Columns
Additional columnsthe following columns are only supplied if an additional parameter is specified:
Example
XML Format
Returns position data for the requested vehicle or vehicle group. If no start and end are given, current position will be returned. Descriptionget_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&format=csv Parameter | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Parameter | Description | Type | Note | Mandatory | company | RTI company key | string | yes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
vehicle | RTI vehcile key | string | vehicle or group parameter | (yes) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
group | RTI group key | string | vehicle or group parameter | (yes) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
start | begin of requested timerange | datestring | Format: YYYYMMDDHHMMSS Date when the message was processed in the data center (insertdate) | no | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
end | end of requested timerange | datestring | Format: YYYYMMDDHHMMSS Date when the message was processed in the data center (insertdate) | no | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
format | return format | string | csv (default) or xml | no |
Separator | Semicolon ( ; ) |
---|---|
Delimiter | Double quote ( " ) |
Line break | 0x0D 0x0A (CarriageReturn LineFeed) |
Header | Line 1 |
Columns
Example
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> <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<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> <d_in> </digital_inputs> <rti_ident>Ident1</rti_ident> <privflag>1</privflag> <digital_temperature_values> <d_nr>4</d_temp> <nr>1</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>digital_temperature_values> <analogue_temperature_values> <d<a_in>temp> <d_nr>6<<nr>1</d_nr> <d_name>Hydraulik</d_name><value>-5</value> <d_state>up</d_state> <d_value>1</d_value> </d_in> </digital_inputs> <rti_ident>Ident1</rti_ident> </yfrtiout> |
JSON Format (RFC 4627)
</a_temp>
</analogue_temperature_values>
</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", | ||
Code Block | ||
[ { "vehsignsat": "35323402432618114", "datespeed": "2016-05-23 08:13:240", "ign": "0", "latreason": "51.0365Telemetriemeldung", "lonkm": "13.599749929", "posinsertdate": "D2016-05-01723 Wilsdruff (Kesselsdorf) Am Wüsteberg 323 08:13:41", "dirutcdate": "402016-05-23 06:13:24", "satdriver": "14Herr Mueller", "speedcustomer": "0Kunde Mueller", "igndriverkey": "012345", "reason": "Telemetriemeldungeta_time": "2015-04-15 09:52:42", "kmeta_dist": "499292015-04-15 09:52:42", "insertdateeta_dur": "2016-05-23 08:13:413600", "utcdateeta_lat": "2016-05-23 06:13:2450.862247", "drivereta_lon": "Herr Mueller12.908245", "customereta_desc": "Kunde Mueller", "driverkeybsz1": "123451234", "eta_time": "2015-04-15 09:52:42bsz2": "", "eta_distdriver2": "2015-04-15 09:52:42John Who", "eta_durdriverkey2": "3600DF1234567890", "etadigital_latinputs": "50.862247", [ { "eta_lon "nr": "12.908245"1, "eta_desc "name": "KundeTemp MuellerInnen", "bsz1": "1234", "bsz2state": "aus", "driver2": "John Who", "driverkey2value": "DF12345678900", "digital_inputs": [ }, { "nr": 12, "name": "Temp InnenAussen", "state": "aus", "value": "0" }, { "nr": 24, "name": "Temp AussenPumpe", "state": "ausoffen", "value": "0" }, { "nr": 46, "name": "PumpeHydraulik", "state": "up", "statevalue": "offen1", } "value], "rti_ident": "Ident1", "privflag": "01", "digital_temperature_values": [ { "nr": 1, "value": }, { 10.5, "set_point": 11 } ], "analogue_temperature_values": [ { "nr": 6, "name": "Hydraulik", "state": "up", "value": "1" } ], "rti_ident": "Ident1" } ] |
Example Calls
1,
"value": -5
}
]
}
] |
Example calls
Code Block | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
https | ||
Code Block | ||
| ||
http://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY | ||
Code Block | ||
| ||
http&start=20150401000000&end=20150401235959&format=xml https://map.yellowfox.de/rti/get_pos.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY{"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&start=20150401000000&end=20150401235959&format=xml |