FAQ

Der Cooldown ist eine Art Bremspedal für Leute mit zu schweren Füßen auf dem Gaspedal.
Er verhindert, dass Speditionen mit Fahrern, welche sich nicht an Geschwindigkeiten halten wollen, denen angeglichen wird, die sich daran halten. Im Grunde ist es ein Wettbewerbs-Ausgleich für weniger schnelle Speditionen.
Es wird für die zurückgelegte Strecke eine Mindestzeit errechnet, welche mit der tatsächlichen Zeit verglichen wird.

Simpel erklärt:
Ist jemand schneller als die errechnete Mindestzeit, so muss dieser die restliche Zeit warten, bevor ein neuer Auftrag durch unser System gestartet werden kann.
Ist jemand langsamer als die errechnete Zeit, so brauch er sich keine Gedanken über eine Wartezeit zum nächsten Auftrags-start zu machen.

Hier wird es nun leider etwas mathematisch, sorry dafür :/

Zunächst werden wir einige „Variablen“ benennen. Da hätten wir:

• L_KM = Die auf dem Land zurückgelegte Strecke,
• F_KM = Die mit der Fähre insgesamt zurückgelegte Strecke, sowie
• CDS = Der Cooldown in Sek/KM.
  ( CDS je nach Spedition einstellbar, Mindest-Einstellungen sind 2,35 s/km für non-Real-Eco- und 2,5 s/km für Real-Eco-Speditionen )
• minS = Die „Mindestzeit“ für die zurückgelegte Strecke, abgehend von Startzeitpunkt
• FS = Die vom Fahrer benötigte Zeit

Basierend auf diesen Variablen werde ich nun mit 2 Beispielen für eine reine auf dem Land zurückgelegte Strecke, sowie eine mit Fähre berechnen

> Beispiel 1:
> gefahrene Strecke auf dem Land: 937Km
> eingestellter CDS der Spedition: 2,5 s/km
> vom Fahrer benötigte Zeit für die Strecke: 1824 sek ( oder 30 min, 24 sek )

Wer nun denkt, jetzt komme eine komplizierte Formel, der irrt sich.
Für eine rein auf dem Land zurückgelegte Strecke wird nun eine einfache Formel verwendet:

L_KM * CDS = minS >> 937km * 2,5 s/km = 2342,5s (39min und 2,5sek)

Wie zuvor bei Punkt 1 erläutert, werden nun die Mindestzeit mit der tatsächlichen Zeit verglichen, und basierend darauf, ob das Ergebnis ‚X‘ größer als 0 ist, bis zum Ende gewartet werden

minS – FS = X >> 2342,5s – 1824s = 518,5s

Laut dieser Rechnung, war der Fahrer schneller als durch unser System berechnet und der Spedition gefordert und muss nach Auftrags-Abgabe weitere 518,5s ( ~9min ) warten bevor er wieder einen Auftrag durch unser System starten kann.
Wäre er etwas langsamer gefahren und hätte für die Strecke mindestens 39min benötigt, so hätte er direkt nach Abgabe einen neuen Auftrag starten können.

> Beispiel 2:
> gefahrene Strecke auf dem Land: 55km
> zurückgelegte Strecke per Fähre: 1255km
> eingestellter CDS der Spedition: 2,35s
> von Fahrer benötigte Zeit für die Strecke: 378s ( 6min 18s )

Nun, jetzt wird es etwas kompliziert, da eine Fähre involviert wurde.
Warum dies so ist, kann in Punkt 3 näher erfahren werden.
Hier verwenden wir nun verschiedene Formeln (sowie fragen nach), ob etwas zutrifft, um unsere Mindestzeit zu errechnen.

WENN ( L_KM ) KLEINER ALS ( F_KM )
↪ DANN minS = (( L_KM * CDS ) + ( F_KM * CDS * ( 1 – ( L_KM / F_KM ))))
↪ ANSONSTEN minS = ( L_KM * CDS )

Uff…. Ja, es ist kompliziert.
Zunächst wird gefragt, ob die auf dem Land zurückgelegte Strecke kleiner als die auf der Fähre verwendete Strecke ist. ( WENN L_KM KLEINER ALS F_KM )
Trifft dies zu wird nun basierend zu der auf dem Land zurückgelegten Strecke deren Mindestzeit nun auch noch ein anteiliger Wert der Mindestzeit von der Fahre hinzugefügt.
Sollte die Fährstrecke jedoch kleiner sein, als die auf dem Land zurückgelegte Strecke, wird die einfache Formel „Land-Strecke * Cooldown in s/km“ verwendet.
Im Beispiel ist jedoch 55km (Land-Strecke) kleiner als 1255km ( Fährstrecke ).
Daraus ergibt sich dann folgende Formel „übersetzt“:

minS =

(( 55km * 2,35s/km ) + ( 1255km * 2,35s/km * ( 1 – ( 55 km / 1255km ))))
↪ (( 129,25s) + ( 2949,25s * ( 1 – ( ~ 0,044 ))))
↪ (( 129,25s) + ( 2949,25s * ( ~0,956 )))
↪ ( 129,25s + 2820s )
↪ 2949,25s

Ja, es ist kompliziert. Nein, wir können es hier nicht vereinfachender erklären. Jedoch bedarf es einfache mathematische Kenntnisse, um sich diese Formel erleichtern zu können.
Wie aber nun aus dieser „super komplizierten“ Formel errechnet, darf die Mindestzeit der zurückgelegten Strecke nicht weniger als 2949,25s ( ~49min ) sein, was mit unserem Beispiel bedeuten würde:

minS – FS = X >> 2949,25s – 378s = 2571,25s ( 42min 51,25s )

Der Fahrer hat nun eine Zeit von ca 43 min als Pause eingeräumt, in derer er keine weiteren Aufträge durch SpedV starten kann/darf.

Die Sonderregelung mit der Fähre wurde ins Leben gerufen, als uns auf einige Unstimmigkeiten mit einer gewissen Fährstrecke aufmerksam gemacht worden ist.
Demnach wurde unser altes System (welches nur die auf dem Land zurückgelegten Strecke verwendet) ausgenutzt und so konnten mehrere Millionen pro Stunde von einer einzigen Person eingefahren werden.
Da es hier eine Ausnutzung durch unser altes System stattfand, wurde in einem „Eilverfahren“ das neue Cooldown-System geschrieben und wird nun verwendet.
Die betroffenen Nutzer haben jedoch gegen keine Richtlinien direkt verstoßen, da alles gemäß der damaligen Richtlinien stattfand.
Seit der neuen Regelung wurde jedoch die erwähnte Fährstrecke nicht mehr weiter verwendet, um sich einen Vorteil zu verschaffen.

• Neue Niederlassung gründen: 180.000 € (3 Fahrzeuge)
• Niederlassung erweitern: 50.000 € (jeweils für ein Fahrzeug, maximal 18 pro Niederlassung)
• Mietkosten pro Monat / 5 Tage (normal): 4.826 € + (1.644 € * Plätze)
• Mietkosten pro Monat / 5 Tage (Real Eco): 215 € + (310 € * Plätze)

Die Speditionen haben die Wahl, Niederlassungen zu gründen, sodass User LKWs kaufen können, oder die LKWs für jede Tour „auszuleihen“. Jeder User kann, wenn er bei einer Tour einen neuen LKW benutzt sich entscheiden, ob er ihn auf Speditionskosten kaufen will oder ihn für die Tour „mieten“ möchte. Aber Achtung: Die Speditionsleitung kann eine maximale Anzahl an LKWs pro User festlegen (Standardmäßig 2).

Endpunkt:

https://api.sped-v.de/rest/api?apikey=APIKey&function=Funktion

Funktionen:

getpositions (ohne API-Key Parameter, optional weiterer Parameter id (Spedition), optional weiterer Parameter sp (Singleplayer mitanzeigen)): Ruft eine Liste mit Koordinaten aller aktuell fahrenden Nutzer ab.

getuserprofile (weiterer Parameter id): Gibt das Userprofil eines Nutzers zurück.

getuserprofiles: Gibt Userprofile von Nutzern aus der Spedi aus.

getonlineusers: Ruft eine Liste der aktuell angemeldeten Nutzer ab.

getusers (optional Parameter includePartnerships (User aus Partnerschaften mitanzeigen)): Gibt alle Nutzer der Spedition zurück

getuserstats: Gibt die Nutzerstatistik zurück

getranks: Gibt (mit entsp. Rechten) die Ränge der Spedi aus

getbranches: Gibt (mit entsp. Rechten) die Niederlassungen der Spedi aus

gettrucks: Gibt (mit entsp. Rechten) die LKWs der Spedi aus

gettasks: Gibt alle Aufträge der Spedi aus

gettask (weiterer Parameter id): Gibt genauere Informationen zu einem Auftrag zurück

gettaskdrivedata (weiterer Parameter id): Gibt den Fahrtverlauf eines Auftrags zurück.

getsped: Gibt vollständige Speditionsinfos aus

getspedmoney (optional Parameter includePartnerships (Konten aus Partnerschaften mitanzeigen)): Gibt (mit entsp. Rechten) die Bankkonten der Spedi aus

getspedpartnerships: Gibt die Partnerschaften der Spedition zurück

getspedtarget: Gibt das Speditionsziel aus

getspedstats: Gibt Speditionsstatistiken aus

getvacations: Gibt (mit entsp. Rechten) Urlaube aus

gettrucktypes: Gibt alle vorhandenen LKW-Typen aus

getacttask: Gibt den aktuellen Auftrag des angemeldeten Nutzers aus

getownconvoyinfo: Gibt vollständige Fahrtdaten des angemeldeten Nutzers aus

whoami: Gibt zurück, zu wem der API-Key gehört

getmyrank: Gibt den Rang des angemeldeten Nutzers zurück.

getsystemstats: Gibt Systemstatistiken aus.

getkontorbranchs (weiterer Parameter map, optional weiterer Parameter includePartnerships (Lager aus Partnerschaften mitanzeigen)): Gibt die Kontor Lager aus.

getkontortrailers (weiterer Parameter map, optional weiterer Parameter includePartnerships (Trailer aus Partnerschaften mitanzeigen)): Gibt die Kontor Trailer aus.

getkontoroffers (weiterer Parameter map): Gibt das Kontor Auftragsangebot aus.

getkontorofferparts (weiterer Parameter map, optional weiterer Parameter includePartnerships (Angebot aus Partnerschaften mitanzeigen)): Gibt das Kontor Fahrtangebot aus.

getkontorspedoffers (weiterer Parameter map): Gibt die Kontor Aufträge der Spedition aus.

getkontorspedparts (weiterer Parameter map, optional weiterer Parameter includePartnerships (Fahrten aus Partnerschaften mitanzeigen)): Gibt die Kontor Fahrten der Spedition aus.

getkontormaps: Gibt die unterstützten Karten des Kontor Modus aus.

getcountries: Gibt alle vorhandenen Länder aus.

getchats: Gibt alle Chats des angemeldeten Nutzers zurück.

getchatmessages (weiterer Parameter id): Gibt die Nachrichten eines Chats zurück.

getspedchat: Gibt den Speditionschat des angemeldeten Nutzers zurück.