Versions Compared

Key

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

Setzt den Korrekturfaktor für die Distanzberechnung für ein Fahrzeug. Dieser kann helfen die Genauigkeit des Kilometerstandes für Fahrzeuge, die diesen GPS-basiert ermitteln, zu verbessern.

Beschreibung

Status
colourGreen
titleGET
vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&correctionFactor=FACTOR

Voraussetzungen und Beschränkungen

Diese Funktion wird von allen Boxen unterstützt, die in der Lage sind, GPS-basiert einen Kilometerstand zu erfassen. Dazu gehören YellowTracker 100 bis 620, sowie auch der YellowTracker mobile Xtreme. Ausgeschlossen sind OEM Anbindungen oder auch Mobile Apps. Einige Boxen unterstützen auch eine Kilometerstandserfassung über Digitacho oder Squarell. Wurde bei solch einer Box die Kilometerstandsquelle auf etwas anderes als GPS gesetzt, so kann kein Korrekturfaktor mehr gesetzt werden. Prinzipiell sind diese Quellen für einen genauen Kilometerstand zu bevorzugen. Die Kilometerstandsquelle können Sie im Portal über die fahrzeugbezogenen Einstellungen setzen.

Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
vehicleRTI Fahrzeugschlüsselstring
ja
correctionFactorKorrekturfaktorfloat

Korrekturfaktor der gesetzt werden soll.

Muss zwischen 0.8 und 1.2 liegen.

ja

Rückgabe

Es wird ein string zurückgegeben. Bei Erfolg wird als Antwort "OK" zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

Beispielaufrufe

Code Block
https://map.yellowfox.de/rti/vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&correctionFactor=1.8

https://map.yellowfox.de/rti/vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&correctionFactor=1.8


Sv translation
languageen

Sets the correction factor for distance calcularion for a vehicle. This can help vehicles which calculate their odometer based on GPS values to improve their precision.

Description

Status
colourGreen
titleGET
vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&correctionFactor=FACTOR

Requirements and restrictions

This function is supported by all boxtypes, which are able to track odometer values based on GPS. This includes the YellowTracker 100 to 620, as well as the YellowTracker mobile Xtreme. Vehicles imported by OEM interfaces or mobile apps are not included. Some boxtypes support odometer values imported via Digitacho or Squarell. If such a box has set its odometer source to something else than GPS, you will not be able to set a correction value. These odometer sources should be preferred for getting precise odometer values. You can change the odometer source at the portal at vehicle-based settings. 

Parameter

ParameterDescriptionTypeHintMandatory
companyRTI company keystring
yes
vehicleRTI vehicle keystring
yes
correctionFactorcorrection factorfloat

Correction factor to be set.

Hast to be between 08. and 1.2.

yes

Return value

A string will be returned. Will return "OK" on success. On error "ERROR:description" will be returned.

Example calls

Code Block
https://map.yellowfox.de/rti/vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&correctionFactor=1.8

https://map.yellowfox.de/rti/vehicle_settings/set_odometer_correction_factor.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&correctionFactor=1.8