gtfs 4.5.1 → 4.7.0

package/@types/index.d.ts

@@ -152,7 +152,7 @@ export function getAgencies(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -162,7 +162,7 @@ export function getAreas(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -172,7 +172,7 @@ export function getAttributions(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -182,7 +182,7 @@ export function getRoutes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -192,7 +192,7 @@ export function getStops(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -201,7 +201,7 @@ export function getStops(
  */
 export function getStopsAsGeoJSON(
   query?: SqlWhere,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): Promise<FeatureCollection<Geometry, { [name: string]: any }>>;
 
 /**
@@ -211,7 +211,7 @@ export function getStoptimes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -221,7 +221,7 @@ export function getTrips(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -231,7 +231,7 @@ export function getShapes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -240,7 +240,7 @@ export function getShapes(
  */
 export function getShapesAsGeoJSON(
   query?: SqlWhere,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): FeatureCollection<Geometry, { [name: string]: any }>;
 
 /**
@@ -250,7 +250,7 @@ export function getCalendars(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -260,7 +260,7 @@ export function getCalendarDates(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -270,7 +270,7 @@ export function getFareAttributes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -280,7 +280,7 @@ export function getFareLegRules(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -290,7 +290,7 @@ export function getFareProducts(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -300,7 +300,7 @@ export function getFareRules(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -310,7 +310,7 @@ export function getFareTransferRules(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -320,7 +320,7 @@ export function getFeedInfo(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -330,7 +330,7 @@ export function getFrequencies(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -340,7 +340,7 @@ export function getLevels(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -350,7 +350,7 @@ export function getPathways(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -360,7 +360,7 @@ export function getTransfers(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -370,7 +370,7 @@ export function getTranslations(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -380,7 +380,7 @@ export function getStopAreas(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -391,7 +391,7 @@ export function getCalendarAttributes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -402,7 +402,7 @@ export function getDirections(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -413,7 +413,7 @@ export function getRouteAttributes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -424,7 +424,7 @@ export function getStopAttributes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -435,7 +435,7 @@ export function getTimetables(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -446,7 +446,7 @@ export function getTimetableStopOrders(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -457,7 +457,7 @@ export function getTimetablePages(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -468,7 +468,7 @@ export function getTimetableNotes(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -479,7 +479,7 @@ export function getTimetableNotesReferences(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -490,7 +490,7 @@ export function getTripsDatedVehicleJourneys(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -501,7 +501,7 @@ export function getServiceAlerts(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -512,18 +512,18 @@ export function getTripUpdates(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
  * Returns an array of GTFS Realtime stop time updates that match query parameters.
  * This only works if you configure GTFS Realtime import in node-gtfs.
  */
-export function getStopTimesUpdates(
+export function getStopTimeUpdates(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -534,7 +534,7 @@ export function getVehiclePositions(
   query?: SqlWhere,
   fields?: SqlSelect,
   sortBy?: SqlOrderBy,
-  options?: QueryOptions
+  options?: QueryOptions,
 ): SqlResults;
 
 /**
@@ -542,5 +542,5 @@ export function getVehiclePositions(
  */
 export function advancedQuery(
   table?: SqlTableName,
-  advancedQueryOptions?: AdvancedQueryOptions
+  advancedQueryOptions?: AdvancedQueryOptions,
 ): SqlResults;

package/CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.7.0] - 2024-02-09
+
+### Added
+
+- Added `bounding_box_side_m` option to `getStops` and `getStopsAsGeoJSON` to find all stops within a bounding box.
+
+### Updated
+
+- Dependency updates
+
+## [4.6.0] - 2024-01-17
+
+### Changed
+
+- Renamed `getStopTimesUpdates` to `getStopTimeUpdates`.
+
+### Added
+- Added `schedule_relationship`, `trip_start_time`, `direction_id` and `route_id` fields to stop_time_updates and trip_updates tables.
+
+### Updated
+
+- Dependency updates
+
 ## [4.5.1] - 2023-11-09
 
 ### Updated

package/README.md

@@ -737,6 +737,24 @@ const stops = getStops({
 const stops = getStops({
   shape_id: 'cal_sf_tam',
 });
+
+/*
+ * `getStops` allows passing a `bounding_box_side_m` value in the options
+ * parameter object. If included, it will return all stops within a square
+ * bounding box around the `stop_lat` and `stop_lon` parameters passed to
+ * the query using the size in meters specified.
+ */
+const stops = getStops(
+  {
+    stop_lat: 37.58764,
+    stop_lon: -122.36265
+  },
+  [],
+  [],
+  {
+    bounding_box_side_m: 1000
+  }
+);
 ```
 
 #### getStopsAsGeoJSON(query, options)
@@ -753,6 +771,17 @@ const stopsGeojson = getStopsAsGeoJSON();
 const stopsGeojson = getStopsAsGeoJSON({
   route_id: 'Lo-16APR',
 });
+
+// Get all stops within a 1000m bounding box as geoJSON
+const stopsGeojson = getStopsAsGeoJSON(
+  {
+    stop_lat: 37.58764,
+    stop_lon: -122.36265
+  },
+  {
+    bounding_box_side_m: 1000
+  }
+);
 ```
 
 #### getStoptimes(query, fields, sortBy, options)
@@ -1189,15 +1218,15 @@ import { getTripUpdates } from 'gtfs';
 const tripUpdates = getTripUpdates();
 ```
 
-#### getStopTimesUpdates(query, fields, sortBy, options)
+#### getStopTimeUpdates(query, fields, sortBy, options)
 
 Returns an array of GTFS Realtime stop time updates that match query parameters. [Details on Stop Time Updates](https://gtfs.org/realtime/feed-entities/trip-updates/#stoptimeupdate)
 
 ```js
-import { getStopTimesUpdates } from 'gtfs';
+import { getStopTimeUpdates } from 'gtfs';
 
-// Get all stop times updates
-const stopTimesUpdates = getStopTimesUpdates();
+// Get all stop time updates
+const stopTimeUpdates = getStopTimeUpdates();
 ```
 
 #### getVehiclePositions(query, fields, sortBy, options)

package/lib/gtfs/stops.js

@@ -7,6 +7,7 @@ import {
   formatOrderByClause,
   formatSelectClause,
   formatWhereClause,
+  formatWhereClauseBoundingBox,
   formatWhereClauses,
 } from '../utils.js';
 import { stopsToGeoJSON } from '../geojson-utils.js';
@@ -21,7 +22,7 @@ function buildTripSubquery(query) {
 
 function buildStoptimeSubquery(query) {
   return `SELECT DISTINCT stop_id FROM stop_times WHERE trip_id IN (${buildTripSubquery(
-    query
+    query,
   )})`;
 }
 
@@ -39,13 +40,21 @@ export function getStops(query = {}, fields = [], orderBy = [], options = {}) {
   let whereClause = '';
   const orderByClause = formatOrderByClause(orderBy);
 
-  const stopQuery = omit(query, [
+  const stopQueryOmitKeys = [
     'route_id',
     'trip_id',
     'service_id',
     'direction_id',
     'shape_id',
-  ]);
+  ];
+
+  // If bounding_box_side_m is defined, search for stops inside a bounding box so omit `stop_lat` and `stop_lon`.
+  if (options.bounding_box_side_m !== undefined) {
+    stopQueryOmitKeys.push('stop_lat', 'stop_lon');
+  }
+
+  let stopQuery = omit(query, stopQueryOmitKeys);
+
   const tripQuery = pick(query, [
     'route_id',
     'trip_id',
@@ -55,9 +64,23 @@ export function getStops(query = {}, fields = [], orderBy = [], options = {}) {
   ]);
 
   const whereClauses = Object.entries(stopQuery).map(([key, value]) =>
-    formatWhereClause(key, value)
+    formatWhereClause(key, value),
   );
 
+  if (
+    options.bounding_box_side_m !== undefined &&
+    query.stop_lat !== undefined &&
+    query.stop_lon !== undefined
+  ) {
+    whereClauses.push(
+      formatWhereClauseBoundingBox(
+        query.stop_lat,
+        query.stop_lon,
+        options.bounding_box_side_m,
+      ),
+    );
+  }
+
   if (Object.values(tripQuery).length > 0) {
     whereClauses.push(`stop_id IN (${buildStoptimeSubquery(tripQuery)})`);
   }
@@ -68,7 +91,7 @@ export function getStops(query = {}, fields = [], orderBy = [], options = {}) {
 
   return db
     .prepare(
-      `${selectClause} FROM ${tableName} ${whereClause} ${orderByClause};`
+      `${selectClause} FROM ${tableName} ${whereClause} ${orderByClause};`,
     )
     .all();
 }
@@ -96,7 +119,7 @@ export function getStopsAsGeoJSON(query = {}, options = {}) {
     const stopAttributes = getStopAttributes({ stop_id: stop.stop_id });
 
     stop.routes = orderBy(routes, (route) =>
-      Number.parseInt(route.route_short_name, 10)
+      Number.parseInt(route.route_short_name, 10),
     );
     stop.agency_name = agencies[0].agency_name;
 

package/lib/gtfs-realtime/{stop-times-updates.js → stop-time-updates.js}

@@ -7,16 +7,16 @@ import {
   formatSelectClause,
   formatWhereClauses,
 } from '../utils.js';
-import stopTimeUpdates from '../../models/gtfs-realtime/stop-times-updates.js';
+import stopTimeUpdates from '../../models/gtfs-realtime/stop-time-updates.js';
 
 /*
- * Returns an array of all stop times updates that match the query parameters.
+ * Returns an array of all stop time updates that match the query parameters.
  */
-export function getStopTimesUpdates(
+export function getStopTimeUpdates(
   query = {},
   fields = [],
   orderBy = [],
-  options = {}
+  options = {},
 ) {
   const db = options.db ?? openDb();
   const tableName = sqlString.escapeId(stopTimeUpdates.filenameBase);
@@ -26,7 +26,7 @@ export function getStopTimesUpdates(
 
   return db
     .prepare(
-      `${selectClause} FROM ${tableName} ${whereClause} ${orderByClause};`
+      `${selectClause} FROM ${tableName} ${whereClause} ${orderByClause};`,
     )
     .all();
 }

package/lib/gtfs.js

@@ -50,7 +50,7 @@ import { getRiderships } from './gtfs-ride/riderships.js';
 import { getTripCapacities } from './gtfs-ride/trip-capacities.js';
 
 // GTFS-Realtime Filenames
-import { getStopTimesUpdates } from './gtfs-realtime/stop-times-updates.js';
+import { getStopTimeUpdates } from './gtfs-realtime/stop-time-updates.js';
 import { getTripUpdates } from './gtfs-realtime/trip-updates.js';
 import { getVehiclePositions } from './gtfs-realtime/vehicle-positions.js';
 import { getServiceAlerts } from './gtfs-realtime/service-alerts.js';
@@ -191,8 +191,8 @@ export { _getTripCapacities as getTripCapacities };
 const _updateGtfsRealtime = updateGtfsRealtime;
 export { _updateGtfsRealtime as updateGtfsRealtime };
 
-const _getStopTimesUpdates = getStopTimesUpdates;
-export { _getStopTimesUpdates as getStopTimesUpdates };
+const _getStopTimeUpdates = getStopTimeUpdates;
+export { _getStopTimeUpdates as getStopTimeUpdates };
 
 const _getTripUpdates = getTripUpdates;
 export { _getTripUpdates as getTripUpdates };

package/lib/import.js

@@ -9,7 +9,7 @@ import stripBomStream from 'strip-bom-stream';
 import { dir } from 'tmp-promise';
 import untildify from 'untildify';
 import mapSeries from 'promise-map-series';
-import gtfsrt from 'gtfs-realtime-bindings';
+import GtfsRealtimeBindings from 'gtfs-realtime-bindings';
 import sqlString from 'sqlstring-sqlite';
 
 import models from '../models/models.js';
@@ -59,7 +59,18 @@ const downloadGtfsRealtimeData = async (url, headers) => {
   }
 
   const buffer = await response.arrayBuffer();
-  return gtfsrt.transit_realtime.FeedMessage.decode(Buffer.from(buffer));
+  const message = GtfsRealtimeBindings.transit_realtime.FeedMessage.decode(
+    new Uint8Array(buffer),
+  );
+  return GtfsRealtimeBindings.transit_realtime.FeedMessage.toObject(message, {
+    enums: String,
+    longs: String,
+    bytes: String,
+    defaults: true,
+    arrays: true,
+    objects: true,
+    oneofs: true,
+  });
 };
 
 function getDescendantProp(obj, desc, defaultvalue) {
@@ -69,11 +80,19 @@ function getDescendantProp(obj, desc, defaultvalue) {
     const nextKey = arr.shift();
     if (nextKey.includes('[')) {
       const arrayKey = nextKey.match(/(\w*)\[(\d+)\]/);
-      if (!obj[arrayKey[1]]) return defaultvalue;
-      if (!obj[arrayKey[1]][arrayKey[2]]) return defaultvalue;
+      if (obj[arrayKey[1]] === undefined) {
+        return defaultvalue;
+      }
+
+      if (obj[arrayKey[1]][arrayKey[2]] === undefined) {
+        return defaultvalue;
+      }
+
       obj = obj[arrayKey[1]][arrayKey[2]];
     } else {
-      if (!obj[nextKey]) return defaultvalue;
+      if (obj[nextKey] === undefined) {
+        return defaultvalue;
+      }
       obj = obj[nextKey];
     }
   }
@@ -87,11 +106,11 @@ const markRealtimeDataStale = (config, log) => {
   const db = openDb(config);
 
   log(`Marking GTFS-Realtime data as stale..`);
-  db.prepare(`UPDATE vehicle_positions SET isUpdated=0`).run();
-  db.prepare(`UPDATE trip_updates SET isUpdated=0`).run();
-  db.prepare(`UPDATE stop_times_updates SET isUpdated=0`).run();
-  db.prepare(`UPDATE service_alerts SET isUpdated=0`).run();
-  db.prepare(`UPDATE service_alert_targets SET isUpdated=0`).run();
+  db.prepare(`UPDATE vehicle_positions SET is_updated=0`).run();
+  db.prepare(`UPDATE trip_updates SET is_updated=0`).run();
+  db.prepare(`UPDATE stop_time_updates SET is_updated=0`).run();
+  db.prepare(`UPDATE service_alerts SET is_updated=0`).run();
+  db.prepare(`UPDATE service_alert_targets SET is_updated=0`).run();
   log(`Marked GTFS-Realtime data as stale\r`, true);
 };
 
@@ -99,11 +118,11 @@ const cleanStaleRealtimeData = (config, log) => {
   const db = openDb(config);
 
   log(`Cleaning stale GTFS-RT data..`);
-  db.prepare(`DELETE FROM vehicle_positions WHERE isUpdated=0`).run();
-  db.prepare(`DELETE FROM trip_updates WHERE isUpdated=0`).run();
-  db.prepare(`DELETE FROM stop_times_updates WHERE isUpdated=0`).run();
-  db.prepare(`DELETE FROM service_alerts WHERE isUpdated=0`).run();
-  db.prepare(`DELETE FROM service_alert_targets WHERE isUpdated=0`).run();
+  db.prepare(`DELETE FROM vehicle_positions WHERE is_updated=0`).run();
+  db.prepare(`DELETE FROM trip_updates WHERE is_updated=0`).run();
+  db.prepare(`DELETE FROM stop_time_updates WHERE is_updated=0`).run();
+  db.prepare(`DELETE FROM service_alerts WHERE is_updated=0`).run();
+  db.prepare(`DELETE FROM service_alert_targets WHERE is_updated=0`).run();
   log(`Cleaned stale GTFS-Realtime data\r`, true);
 };
 
@@ -115,8 +134,8 @@ const updateRealtimeData = async (task) => {
       (x) => x.filenameBase === 'vehicle_positions',
     ),
     trip_updates: models.find((x) => x.filenameBase === 'trip_updates'),
-    stop_times_updates: models.find(
-      (x) => x.filenameBase === 'stop_times_updates',
+    stop_time_updates: models.find(
+      (x) => x.filenameBase === 'stop_time_updates',
     ),
     service_alerts: models.find((x) => x.filenameBase === 'service_alerts'),
     service_alert_targets: models.find(
@@ -131,7 +150,7 @@ const updateRealtimeData = async (task) => {
     trip_updates: model.trip_updates.schema
       .map((column) => column.name)
       .join(', '),
-    stop_times_updates: model.stop_times_updates.schema
+    stop_time_updates: model.stop_time_updates.schema
       .map((column) => column.name)
       .join(', '),
     service_alerts: model.service_alerts.schema
@@ -149,14 +168,20 @@ const updateRealtimeData = async (task) => {
   for (const realtimeUrl of task.realtime_urls) {
     task.log(`Downloading GTFS-Realtime from ${realtimeUrl}`);
     // eslint-disable-next-line no-await-in-loop
-    const tripUpdateData = await downloadGtfsRealtimeData(
+    const gtfsRealtimeData = await downloadGtfsRealtimeData(
       realtimeUrl,
       task.realtime_headers,
     );
+
     task.log(`Download successful`);
 
+    if (!gtfsRealtimeData.entity) {
+      continue;
+    }
+
     let totalLineCount = 0;
-    for (const entity of tripUpdateData.entity) {
+
+    for (const entity of gtfsRealtimeData.entity) {
       // Determine the type of GTFS-Realtime
       let gtfsRealtimeType = null;
       if (entity.vehicle) {
@@ -194,23 +219,23 @@ const updateRealtimeData = async (task) => {
 
       // Special processing for tripUpdates
       if (entity.tripUpdate) {
-        const stopUpdateArray = [];
-        for (const stopUpdate of entity.tripUpdate.stopTimeUpdate) {
-          stopUpdate.parent = entity;
-          const subValues = model.stop_times_updates.schema.map((column) =>
+        const stopTimeUpdateArray = [];
+        for (const stopTimeUpdate of entity.tripUpdate.stopTimeUpdate) {
+          stopTimeUpdate.parent = entity;
+          const subValues = model.stop_time_updates.schema.map((column) =>
             sqlString.escape(
-              getDescendantProp(stopUpdate, column.source, column.default),
+              getDescendantProp(stopTimeUpdate, column.source, column.default),
             ),
           );
-          stopUpdateArray.push(`(${subValues.join(', ')})`);
+          stopTimeUpdateArray.push(`(${subValues.join(', ')})`);
           totalLineCount++;
         }
 
         try {
           db.prepare(
-            `REPLACE INTO ${model.stop_times_updates.filenameBase} (${
-              fields.stop_times_updates
-            }) VALUES ${stopUpdateArray.join(', ')}`,
+            `REPLACE INTO ${model.stop_time_updates.filenameBase} (${
+              fields.stop_time_updates
+            }) VALUES ${stopTimeUpdateArray.join(', ')}`,
           ).run();
         } catch (error) {
           task.warn('Import error: ' + error.message);

package/lib/utils.js

@@ -12,7 +12,7 @@ export function validateConfigForImport(config) {
   for (const [index, agency] of config.agencies.entries()) {
     if (!agency.path && !agency.url) {
       throw new Error(
-        `No Agency \`url\` or \`path\` specified in config for agency index ${index}.`
+        `No Agency \`url\` or \`path\` specified in config for agency index ${index}.`,
       );
     }
   }
@@ -75,7 +75,7 @@ export function formatSelectClause(fields) {
 
   const selectItem = Object.entries(fields)
     .map(
-      (key) => `${sqlString.escapeId(key[0])} AS ${sqlString.escapeId(key[1])}`
+      (key) => `${sqlString.escapeId(key[0])} AS ${sqlString.escapeId(key[1])}`,
     )
     .join(', ');
   return `SELECT ${selectItem}`;
@@ -86,12 +86,48 @@ export function formatJoinClause(joinObject) {
     .map(
       (data) =>
         `${data.type ? data.type + ' JOIN' : 'INNER JOIN'} ${sqlString.escapeId(
-          data.table
-        )} ON ${data.on}`
+          data.table,
+        )} ON ${data.on}`,
     )
     .join(' ');
 }
 
+function degree2radian(angle) {
+  return (angle * Math.PI) / 180;
+}
+
+function radian2degree(angle) {
+  return (angle / Math.PI) * 180;
+}
+
+/*
+ * Search inside GPS coordinates boundary box
+ * Distance unit: meters
+ * */
+export function formatWhereClauseBoundingBox(
+  latitudeDegree,
+  longitudeDegree,
+  boundingBoxSideMeters,
+) {
+  const earthRadius = 6371000;
+  latitudeDegree = parseFloat(latitudeDegree);
+  longitudeDegree = parseFloat(longitudeDegree);
+
+  const latitudeRadian = degree2radian(latitudeDegree);
+  const radiusFromLatitude = Math.cos(latitudeRadian) * earthRadius;
+
+  // `boundingBoxSideMeters` is divided by 2 we are centering the coordinates in the middle of this square
+  const deltaLatitude = radian2degree(boundingBoxSideMeters / 2 / earthRadius);
+  const deltaLongitude = radian2degree(
+    boundingBoxSideMeters / 2 / radiusFromLatitude,
+  );
+
+  let query = `stop_lat BETWEEN ${latitudeDegree - deltaLatitude} AND ${latitudeDegree + deltaLatitude}`;
+  query += ` AND stop_lon BETWEEN ${longitudeDegree - deltaLongitude} AND ${longitudeDegree + deltaLongitude}`;
+
+  return query;
+}
+
 export function formatWhereClause(key, value) {
   if (Array.isArray(value)) {
     let whereClause = `${sqlString.escapeId(key)} IN (${value
@@ -119,7 +155,7 @@ export function formatWhereClauses(query) {
   }
 
   const whereClauses = Object.entries(query).map(([key, value]) =>
-    formatWhereClause(key, value)
+    formatWhereClause(key, value),
   );
   return `WHERE ${whereClauses.join(' AND ')}`;
 }

package/models/gtfs-realtime/service-alert-targets.js

@@ -24,7 +24,7 @@ const model = {
       default: null,
     },
     {
-      name: 'isUpdated',
+      name: 'is_updated',
       type: 'integer',
       required: true,
       min: 0,

package/models/gtfs-realtime/service-alerts.js

@@ -47,7 +47,7 @@ const model = {
       default: '',
     },
     {
-      name: 'isUpdated',
+      name: 'is_updated',
       type: 'integer',
       required: true,
       min: 0,

package/models/gtfs-realtime/{stop-times-updates.js → stop-time-updates.js}

@@ -1,5 +1,5 @@
 const model = {
-  filenameBase: 'stop_times_updates',
+  filenameBase: 'stop_time_updates',
   extension: 'gtfs-realtime',
   schema: [
     {
@@ -9,6 +9,18 @@ const model = {
       source: 'parent.tripUpdate.trip.tripId',
       default: null,
     },
+    {
+      name: 'trip_start_time',
+      type: 'varchar(255)',
+      source: 'parent.tripUpdate.trip.startTime',
+      default: null,
+    },
+    {
+      name: 'direction_id',
+      type: 'integer',
+      source: 'parent.tripUpdate.trip.directionId',
+      default: null,
+    },
     {
       name: 'route_id',
       type: 'varchar(255)',
@@ -54,7 +66,13 @@ const model = {
       default: null,
     },
     {
-      name: 'isUpdated',
+      name: 'schedule_relationship',
+      type: 'varchar(255)',
+      source: 'scheduleRelationship',
+      default: null,
+    },
+    {
+      name: 'is_updated',
       type: 'integer',
       required: true,
       min: 0,

package/models/gtfs-realtime/trip-updates.js

@@ -24,6 +24,25 @@ const model = {
       source: 'tripUpdate.trip.tripId',
       default: null,
     },
+    {
+      name: 'trip_start_time',
+      type: 'varchar(255)',
+      source: 'tripUpdate.trip.startTime',
+      default: null,
+    },
+    {
+      name: 'direction_id',
+      type: 'integer',
+      source: 'tripUpdate.trip.directionId',
+      default: null,
+    },
+    {
+      name: 'route_id',
+      type: 'varchar(255)',
+      index: true,
+      source: 'tripUpdate.trip.routeId',
+      default: null,
+    },
     {
       name: 'start_date',
       type: 'varchar(255)',
@@ -37,7 +56,13 @@ const model = {
       default: null,
     },
     {
-      name: 'isUpdated',
+      name: 'schedule_relationship',
+      type: 'varchar(255)',
+      source: 'tripUpdate.trip.scheduleRelationship',
+      default: null,
+    },
+    {
+      name: 'is_updated',
       type: 'integer',
       required: true,
       min: 0,

package/models/gtfs-realtime/vehicle-positions.js

@@ -60,7 +60,7 @@ const model = {
       default: null,
     },
     {
-      name: 'isUpdated',
+      name: 'is_updated',
       type: 'integer',
       required: true,
       min: 0,

package/models/models.js

@@ -40,7 +40,7 @@ import tripCapacity from '../models/gtfs-ride/trip-capacity.js';
 import rideFeedInfo from './gtfs-ride/ride-feed-info.js';
 
 import tripUpdates from './gtfs-realtime/trip-updates.js';
-import stopTimesUpdates from './gtfs-realtime/stop-times-updates.js';
+import stopTimeUpdates from './gtfs-realtime/stop-time-updates.js';
 import vehiclePositions from './gtfs-realtime/vehicle-positions.js';
 import serviceAlerts from './gtfs-realtime/service-alerts.js';
 import serviceAlertTargets from './gtfs-realtime/service-alert-targets.js';
@@ -90,7 +90,7 @@ const models = [
   ridership,
   tripCapacity,
   tripUpdates,
-  stopTimesUpdates,
+  stopTimeUpdates,
   vehiclePositions,
   serviceAlerts,
   serviceAlertTargets,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtfs",
-  "version": "4.5.1",
+  "version": "4.7.0",
   "description": "Import GTFS transit data into SQLite and query routes, stops, times, fares and more",
   "keywords": [
     "transit",
@@ -58,7 +58,8 @@
     "Daniel Sörlöv",
     "Ali Zarghami <alizarghami@gmail.com>",
     "David Abell",
-    "Matthias Feist <matze@matf.de>"
+    "Matthias Feist <matze@matf.de>",
+    "Oliv4945"
   ],
   "type": "module",
   "main": "index.js",
@@ -73,9 +74,9 @@
   },
   "dependencies": {
     "@turf/helpers": "^6.5.0",
-    "better-sqlite3": "^9.1.1",
-    "csv-parse": "^5.5.2",
-    "csv-stringify": "^6.4.4",
+    "better-sqlite3": "^9.4.0",
+    "csv-parse": "^5.5.3",
+    "csv-stringify": "^6.4.5",
     "gtfs-realtime-bindings": "^1.1.1",
     "lodash-es": "^4.17.21",
     "long": "^5.2.3",
@@ -94,10 +95,10 @@
     "yoctocolors": "^1.0.0"
   },
   "devDependencies": {
-    "husky": "^8.0.3",
-    "lint-staged": "^15.0.2",
-    "mocha": "^10.2.0",
-    "prettier": "^3.0.3",
+    "husky": "^9.0.10",
+    "lint-staged": "^15.2.2",
+    "mocha": "^10.3.0",
+    "prettier": "^3.2.5",
     "should": "^13.2.3"
   },
   "engines": {

package/test/mocha/get-stops-as-geojson.js

@@ -64,4 +64,24 @@ describe('getStopsAsGeoJSON(): ', () => {
     should.exist(geojson.features[0].geometry.coordinates);
     geojson.features[0].geometry.coordinates.length.should.equal(2);
   });
+
+  it('should return geojson with specific stops for bounding box query', () => {
+    const distance = 100;
+    const stopLatitude = 37.709538;
+    const stopLongitude = -122.401586;
+
+    const geojson = getStopsAsGeoJSON(
+      {
+        stop_lat: stopLatitude,
+        stop_lon: stopLongitude,
+      },
+      { bounding_box_side_m: distance },
+    );
+
+    should.exist(geojson);
+    geojson.type.should.equal('FeatureCollection');
+    geojson.features.length.should.equal(2);
+    should.exist(geojson.features[0].geometry.coordinates);
+    geojson.features[0].geometry.coordinates.length.should.equal(2);
+  });
 });

package/test/mocha/get-stops.js

@@ -92,7 +92,7 @@ describe('getStops():', () => {
         route_id: routeId,
       },
       [],
-      [['stop_id', 'ASC']]
+      [['stop_id', 'ASC']],
     );
 
     const expectedStopIds = [
@@ -127,7 +127,7 @@ describe('getStops():', () => {
     for (const [idx, stop] of results.entries()) {
       expectedStopIds[idx].should.equal(
         stop.stop_id,
-        'The order of stops are expected to be the same'
+        'The order of stops are expected to be the same',
       );
     }
   });
@@ -142,7 +142,7 @@ describe('getStops():', () => {
         direction_id: directionId,
       },
       [],
-      [['stop_id', 'ASC']]
+      [['stop_id', 'ASC']],
     );
 
     const expectedStopIds = [
@@ -165,7 +165,7 @@ describe('getStops():', () => {
     for (const [idx, stop] of results.entries()) {
       expectedStopIds[idx].should.equal(
         stop.stop_id,
-        'The order of stops are expected to be the same'
+        'The order of stops are expected to be the same',
       );
     }
   });
@@ -178,7 +178,7 @@ describe('getStops():', () => {
         trip_id: tripId,
       },
       [],
-      [['stop_id', 'ASC']]
+      [['stop_id', 'ASC']],
     );
 
     const expectedStopIds = [
@@ -213,7 +213,7 @@ describe('getStops():', () => {
     for (const [idx, stop] of results.entries()) {
       expectedStopIds[idx].should.equal(
         stop.stop_id,
-        'The order of stops are expected to be the same'
+        'The order of stops are expected to be the same',
       );
     }
   });
@@ -226,7 +226,7 @@ describe('getStops():', () => {
         shape_id: shapeId,
       },
       [],
-      [['stop_id', 'ASC']]
+      [['stop_id', 'ASC']],
     );
 
     const expectedStopIds = [
@@ -262,8 +262,82 @@ describe('getStops():', () => {
     for (const [idx, stop] of results.entries()) {
       expectedStopIds[idx].should.equal(
         stop.stop_id,
-        'The order of stops are expected to be the same'
+        'The order of stops are expected to be the same',
       );
     }
   });
+
+  it('should return array of stops for bounding box query', () => {
+    const distance = 100;
+    const stopLatitude = 37.709538;
+    const stopLongitude = -122.401586;
+
+    const results = getStops(
+      {
+        stop_lat: stopLatitude,
+        stop_lon: stopLongitude,
+      },
+      [],
+      [],
+      { bounding_box_side_m: distance },
+    );
+
+    const expectedResult = [
+      {
+        stop_id: 'ctba',
+        stop_code: null,
+        stop_name: 'Bayshore Caltrain',
+        tts_stop_name: null,
+        stop_desc: null,
+        stop_lat: 37.709544,
+        stop_lon: -122.401318,
+        zone_id: null,
+        stop_url: 'http://www.caltrain.com/stations/bayshorestation.html',
+        location_type: 1,
+        parent_station: null,
+        stop_timezone: null,
+        wheelchair_boarding: 1,
+        level_id: null,
+        platform_code: null,
+      },
+      {
+        stop_id: '70032',
+        stop_code: '70032',
+        stop_name: 'Bayshore Caltrain',
+        tts_stop_name: null,
+        stop_desc: null,
+        stop_lat: 37.709544,
+        stop_lon: -122.40198,
+        zone_id: '1',
+        stop_url: 'http://www.caltrain.com/stations/bayshorestation.html',
+        location_type: 0,
+        parent_station: 'ctba',
+        stop_timezone: null,
+        wheelchair_boarding: 1,
+        level_id: null,
+        platform_code: 'SB',
+      },
+      {
+        stop_id: '70031',
+        stop_code: '70031',
+        stop_name: 'Bayshore Caltrain',
+        tts_stop_name: null,
+        stop_desc: null,
+        stop_lat: 37.709537,
+        stop_lon: -122.401586,
+        zone_id: '1',
+        stop_url: 'http://www.caltrain.com/stations/bayshorestation.html',
+        location_type: 0,
+        parent_station: 'ctba',
+        stop_timezone: null,
+        wheelchair_boarding: 1,
+        level_id: null,
+        platform_code: 'NB',
+      },
+    ];
+
+    should.exist(results);
+    results.length.should.equal(3);
+    results.should.match(expectedResult);
+  });
 });