positions/get_fms_data.php
Inhaltsverzeichnis
Gibt die Positionsdaten eines Fahrzeuges oder einer Fahrzeuggruppe zurück.
Wird keine Zeitraumsbegrenzung mitgegeben, wird die jeweilig aktuelle Position zurückgeliefert.
Beschreibung
GET positions/get_fms_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&start=YYYY-MM-DDTHH:MM:SS+HH:mm&end=YYYY-MM-DDTHH:MM:SS+HH:mm
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | Es muss entweder vehicle, group oder import angegeben werden. | (ja) |
| group | RTI Gruppenschlüssel | string | (ja) | |
| import | RTI Importschlüssel | string | (ja) | |
| start | Anfang des Abfragezeitraum | datestring | Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS+HH:mm) | nein |
| end | Ende des Abfragezeitraum | datestring | Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS+HH:mm) | nein |
| query_date | Datum zu welchen Zeitpunkt die jeweilige Position angezeigt werden soll | datestring | Format: ISO 8601 (YYYY-MM-DDTHH:MM:SS+HH:mm) | nein |
| offset | Die Anfrage liefert maximal 5000 Datensätze zurück. Durch ein Offset können Sie den nächsten Block anfragen. | int | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
Feldbeschreibung
Diese Funktion setzt sich dynamisch zusammen. Sie gibt nur die FMS Werte zurück, die für mindestens eines Ihrer abgefragten Fahrzeuge existieren. Das bedeutet, dass möglicherweise nicht alle dokumentierten Schlüssel in Ihrer Rückgabe vorhanden sind. Welche FMS Werte für Sie verfügbar sind, hängt an Ihrem Fahrzeug, der Art der eingebauten Telematikbox und Ihrem gebuchten Fahrzeugtarif. Sollten Sie einen Wert für Ihr Fahrzeug vermissen, kontaktieren Sie gern unseren Support.
FMS Werte werden zyklisch vom Fahrzeug in einer gesammelten Meldung übertragen. Diese Meldungen können Sie mit dieser Funktion abfragen. Bei einigen Werten kann es vorkommen, dass diese nicht in jeder Meldung vorhanden sind. Wenn Sie historische Daten abfragen (d.h. Sie haben ein konkretes Datum übergeben) können Datensätze daher auch NULL Werte enthalten. Wenn Sie ohne Datum anfragen erhalten Sie den aktuellen Stand der Fahrzeuge. Hier erhalten Sie pro FMS Wert den aktuellsten bekannten Wert. Die einzelnen Werte sind aber möglicherweise unterschiedlich alt. Daher enthält die Rückgabe dieser Funktion für jeden einzelnen FMS Wert einen eigenen Zeitstempel.
Kopfdaten
| Feld | Beschreibung |
|---|---|
| _date | Gesetzte Datumseinschränkung |
| _links | Sollte Ihre Anfrage das Limit übersteigen, finden Sie hier einen Link zum nächsten Teil der Ergebnismenge. |
| has_more | Flag ob es noch mehr Daten zu holen gibt. |
Items
| Feld | Beschreibung |
|---|
JSON
Eine JSON Schema Beschreibung der Rückgabe finden Sie hier.
"_date": {
"query_date": "2025-11-07T13:07:23+01:00"
},
"_links": {
"next": {
"href": null
}
},
"has_more": false,
"items": [
{
"unit": {
"licensePlate": "FTL YF 123",
"rtiIdent": null
},
"engineCoolantTemp": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 79
},
"totalFuelUsed": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 44105
},
"tachoUnitSpeed": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 0
},
"cruiseControlActive": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 0
},
"vehicleDistance": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 158169
},
"fuelLevel1": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 46
},
"engineSpeed": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 598
},
"ptoState": {
"gpsDate": null,
"value": null
},
"vehicleMotionDetect": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 0
},
"acceleratorPedalPosition": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 0
},
"totalEngineHours": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 2674
},
"overspeed": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 0
},
"axleWeight": {
"gpsDate": "2025-11-07T11:45:33+01:00",
"value": 14680
},
"serviceDistanceKm": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 136490
},
"directionIndicator": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 1
},
"fuelLevel2": {
"gpsDate": null,
"value": null
},
"enginePercentTorque": {
"gpsDate": "2025-11-07T11:55:40+01:00",
"value": 11
}
}
]}
Beispielaufrufe
Abfrage Zeitraum für eine Gruppe
https://map.yellowfox.de/rti/positions/get_fms_data.php?company=COMPANY_RTIKEY&group=GROUP_RTIKEY&start=2022-09-22T13:23:00%2B00:00:00&end=2022-09-22T14:23:00%2B00:00:00
Abfrage fester Zeitpunkt für ein Fahrzeug
https://map.yellowfox.de/rti/positions/get_fms_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&query_date=2022-09-22T13:23:00%2B00:00:00
Abfrage jetziger Zeitpunkt für ein Fahrzeug mit RTI Ident
https://map.yellowfox.de/rti/positions/get_fms_data.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}