Here you can do an ETA request, which can also use the shift data of the driver and the current position of the vehicle.

This function is only available if the company has booked the module "truck routing".

Description

POST /eta/get_info.php?company=RTI_COMPANYKEY&vehicle=RTI_VEHICLEKEY

Parametera

Query parameters

Parameters	Description	Type	Hint	Mandatory
company	RTI company key	string		yes
vehicle	RTI vehicle key	string		yes

Body parameters

Parameters	Description	Type	Hint	Mandatory
target	Target coordinate Struktur: "target": { "coordinates": { "latitude": 0, "longitude": 0 } }	object		yes
departure	Start coordinate for routing "departure": { "coordinates": { "latitude": 0, "longitude": 0 }, "time": "YYYY-MM-DDTHH:ii:ss+HH:ii" }	object	Wenn departure nicht angegeben wird, wird die letzte bekannte Position des Fahrzeuges genommen. Wenn departure angegeben wird, müssen die Koordinaten angegeben werden. Die Angabe der Zeit ist optional. Die Zeit wird im ISO 8601 Format angegeben.	no
options	Routing options "options": { "traffic_incidents": false, "driving_regulation_ec_561": false, "historic_speed": false }	object	Standardmäßig sind alle Optionen deaktiviert. Sie können auch einzeln angegeben werden. Folgende Optionen gibt es: traffic_incidents: Gibt an ob die aktuelle Verkehrslage (Stau, Baustellen etc.) mit einbezogen werden sollen driving_regulation_ec_561: Gibt an ob die Regelungen bezüglich Lenk- und Ruhezeiten nach EG 561/2006 beachtet werden sollen. Nur dann werden die Daten unter driver_info beachtet. Ist driver_info nicht gesetzt, werden die Daten des aktuell auf dem Fahrzeug angemeldeten Fahrers verwendet. historic_speed: Gibt an ob historische Verkehrsdaten einbezogen werden sollen, also z.B. dass Fahrten während des Berufsverkehrs häufig länger dauern.	no
driver_info	Driver data "driver_info": { "last_time_the_driver_worked": "YYYY-MM-DDTHH:ii:ss+HH:ii", "accumulated_driving_time_since_last_break": 0, "accumulated_driving_time_since_last_daily_rest": 0, "elapsed_time_since_end_of_last_daily_rest": 0 }	object	Wenn driver_info nicht gesetzt ist, werden die Daten des aktuell auf dem Fahrzeug angemeldeten Fahrers verwendet. Die Option driving_regulation_ec_561 muss aktiviert werden, damit die Fahrerdaten Relevanz haben. Folgende Informationen können mitgegeben werden: last_time_the_driver_worked: Zeitpunkt der letzten erfassten Arbeits- oder Lenkzeit. Alles danach wird als Ruhezeit angenommen. Angabe im ISO 8601 Format. accumulated_driving_time_since_last_break: Lenkzeit in Sekunden seit Ende der letzten Pause. Der Fahrer darf maximal 4,5 Stunden am Stück lenken und muss dann eine Pause einlegen. Wurde diese Zeit bereits überschritten, wird dies genauso behandelt als wenn die 4,5 Stunden gerade erst erreicht wurden. accumulated_driving_time_since_last_daily_rest: Lenkzeit in Sekunden seit der letzten Tagesruhe. Der Fahrer darf maximal 9 Stunden lenken, bevor er seine Tagesruhe einlegen muss. Wurde diese Zeit bereits überschritten, wird dies genauso behandelt als wenn die 9 Stunden gerade erst erreicht wurden. elapsed_time_since_end_of_last_daily_rest: Zeit in Sekunden seit dem Ende der letzten Tagesruhe. Spätestens 13 Stunden nach Schichtbeginn (und damit Ende der Tagesruhe) muss die nächste Tagesruhe eingelegt werden. Wurde diese Zeit bereits überschritten, wird dies genauso behandelt als wenn die 13 Stunden gerade erst erreicht wurden. Dieser Wert kann nicht größer als accumulated_driving_time_since_last_daily_rest sein.	no

Return value

If an error occured "ERROR:description" will be returned. Else the data is formatted as JSON.

You can find a detailled description of the return value as JSON schema here.

Return value example

{
    "etaInfo": {
        "successful": true,
        "distance": 27159,
        "duration": 2392,
        "arrivalTime": "2024-03-13T13:39:07+01:00",
        "events": [],
        "errorInfo": null
    },
    "etaCalculationBase": {
        "startPosition": {
            "coordinate": {
                "longitude": 13.35057,
                "latitude": 50.9218
            }
        },
        "endPosition": {
            "coordinate": {
                "longitude": 13.59894,
                "latitude": 51.03615
            }
        },
        "startTime": "2024-03-13T12:59:15+01:00",
        "options": {
            "traffic_incidents": false,
            "driving_regulation_ec_561": true,
            "historic_speed": false
        },
        "driverInfo": {
            "lastTimeWorked": "2024-03-13T11:24:00+01:00",
            "accumulatedDrivingTimeSinceLastBreak": 15480,
            "accumulatedDrivingTimeSinceLastDailyRest": 15480,
            "elapsedTimeSinceEndOfLastDailyRest": 15480
        },
        "routingProfile": {
            "speedProfile": "carfast",
            "optimization": 0,
            "lowEmissionZoneType": "GREEN",
            "totalPermittedWeight": 0,
            "axleLoad": 0,
            "numberOfAxles": 0,
            "height": 0,
            "length": 0,
            "width": 0,
            "isDelivery": false,
            "isEmergency": false,
            "isMaintenance": false,
            "hazardousGoodsType": "NONE",
            "tunnelRestrictionCode": "NONE",
            "loadType": "PASSENGER",
            "avoidMotorway": false,
            "avoidToll": false,
            "avoidFerry": false,
            "emissionClass": "EURO_0",
            "particleReductionClass": ""
        }
    },
    "queryDate": "2024-03-13T12:59:15+01:00",
    "duration": 0.6310160160064697
}

Example calls

Request with RTI key

https://map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY

Request with RTI ident

https://map.yellowfox.de/rti/eta/get_info.php?company=COMPANY_RTIKEY={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}

Page tree

get_info.php