@tmlmobilidade/geo 20260330.1756.23 → 20260331.1620.53

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export * from './geojson-collections.js';
 export * from './get-geofence-on-point.js';
 export * from './is-point-in-polygon.js';
 export * from './measurements.js';
+export * from './vehicle-event-to-geojson.js';

package/dist/index.js

@@ -7,3 +7,4 @@ export * from './geojson-collections.js';
 export * from './get-geofence-on-point.js';
 export * from './is-point-in-polygon.js';
 export * from './measurements.js';
+export * from './vehicle-event-to-geojson.js';

package/dist/vehicle-event-to-geojson.d.ts

@@ -0,0 +1,16 @@
+import { SimplifiedVehicleEvent, Vehicle } from '@tmlmobilidade/types';
+/**
+ * Converts a SimplifiedVehicleEvent object into a GeoJSON Feature of type Point.
+ *
+ * @param vehiclePositionData - Object containing vehicle position and metadata.
+ * @returns A GeoJSON Feature representing the vehicle's geographic location and associated properties.
+ *
+ * Properties embedded in the feature:
+ * - agency_id: ID of the agency the vehicle belongs to
+ * - bearing:   Heading in degrees
+ * - id:        Vehicle identifier (duplicated for GeoJSON "properties.id" key)
+ * - lat:       Vehicle latitude
+ * - lon:       Vehicle longitude
+ * - trip_id:   Associated trip identifier
+ */
+export declare function transformVehicleDataIntoGeoJsonFeature(event: SimplifiedVehicleEvent, vehicleData?: Vehicle): GeoJSON.Feature<GeoJSON.Point>;

package/dist/vehicle-event-to-geojson.js

@@ -0,0 +1,30 @@
+/* * */
+/* * */
+/**
+ * Converts a SimplifiedVehicleEvent object into a GeoJSON Feature of type Point.
+ *
+ * @param vehiclePositionData - Object containing vehicle position and metadata.
+ * @returns A GeoJSON Feature representing the vehicle's geographic location and associated properties.
+ *
+ * Properties embedded in the feature:
+ * - agency_id: ID of the agency the vehicle belongs to
+ * - bearing:   Heading in degrees
+ * - id:        Vehicle identifier (duplicated for GeoJSON "properties.id" key)
+ * - lat:       Vehicle latitude
+ * - lon:       Vehicle longitude
+ * - trip_id:   Associated trip identifier
+ */
+export function transformVehicleDataIntoGeoJsonFeature(event, vehicleData) {
+    return {
+        geometry: {
+            coordinates: [event.longitude, event.latitude],
+            type: 'Point',
+        },
+        id: `${event.agency_id}-${event.vehicle_id}`,
+        properties: {
+            ...(vehicleData ?? {}),
+            ...event,
+        },
+        type: 'Feature',
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/geo",
-	"version": "20260330.1756.23",
+	"version": "20260331.1620.53",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"