@tmlmobilidade/databases 20260528.1652.52 → 20260528.1745.17

package/dist/interfaces/vehicle-events/simplified-vehicle-events.d.ts

@@ -52,8 +52,8 @@ declare class SimplifiedVehicleEventsNewClass extends ClickHouseInterfaceTemplat
      * @param secondsAgo - The number of seconds in the past to consider for retrieving recent positions. Defaults to 90 seconds.
      * @returns A promise resolving to an array of SimplifiedVehicleEvent objects, each representing the latest event for a vehicle within the specified period.
      *
-     * The method filters out events where any of vehicle_id, agency_id, or trip_id are empty or null,
-     * and also ensures latitude and longitude are not zero. Only the most recent event per vehicle is returned.
+     * When the latest event has no bearing, the immediately previous event's bearing is used if that
+     * event is at most 5 minutes older; otherwise bearing stays null.
      */
     getPositions(secondsAgo?: number): Promise<SimplifiedVehicleEvent[]>;
     /**

package/dist/interfaces/vehicle-events/simplified-vehicle-events.js

@@ -62,13 +62,29 @@ class SimplifiedVehicleEventsNewClass extends ClickHouseInterfaceTemplate {
      * @param secondsAgo - The number of seconds in the past to consider for retrieving recent positions. Defaults to 90 seconds.
      * @returns A promise resolving to an array of SimplifiedVehicleEvent objects, each representing the latest event for a vehicle within the specified period.
      *
-     * The method filters out events where any of vehicle_id, agency_id, or trip_id are empty or null,
-     * and also ensures latitude and longitude are not zero. Only the most recent event per vehicle is returned.
+     * When the latest event has no bearing, the immediately previous event's bearing is used if that
+     * event is at most 5 minutes older; otherwise bearing stays null.
      */
     async getPositions(secondsAgo = 90) {
+        const bearingInferenceLookbackSeconds = 300;
+        const bearingInferenceMaxGapMs = bearingInferenceLookbackSeconds * 1000;
         const query = `
 			SELECT *
-			FROM "${this.databaseName}"."${this.tableName}"
+			FROM (
+				SELECT
+					* REPLACE(
+						if(
+							bearing IS NULL
+							AND lagInFrame(created_at) OVER w IS NOT NULL
+							AND (created_at - lagInFrame(created_at) OVER w) <= ${bearingInferenceMaxGapMs},
+							lagInFrame(bearing) OVER w,
+							bearing
+						) AS bearing
+					)
+				FROM "${this.databaseName}"."${this.tableName}"
+				WHERE created_at > toUnixTimestamp64Milli(now64(3) - INTERVAL ${secondsAgo + bearingInferenceLookbackSeconds} SECOND)
+				WINDOW w AS (PARTITION BY vehicle_id, agency_id ORDER BY created_at)
+			)
 			WHERE created_at > toUnixTimestamp64Milli(now64(3) - INTERVAL ${secondsAgo} SECOND)
 			ORDER BY created_at DESC
 			LIMIT 1 BY vehicle_id, agency_id

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/databases",
-	"version": "20260528.1652.52",
+	"version": "20260528.1745.17",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"