Documentation Center

Help & Documentation

Learn how to use Where Is My Bus like a pro. Find quick answers, tutorials, and deep dives into our technical infrastructure.

Core Features

Real-time Live GPS Tracking

Watch your transit route move live on detailed interactive maps with zero latency.

Real-world Road Geometries

Unlike typical tracking apps that show straight lines between stops, our system queries and renders actual physical road alignments using open-source routing APIs. This ensures you know the exact path your bus is taking.

High-frequency Telemetry

Each bus transmits active GPS telemetry coordinates every 10–20 seconds. This live ping is rendered instantly as a moving icon on the map with a glowing animation to indicate active communication.

Real-time ETAs

Instead of relying on rigid, outdated paper timetables, our proprietary prediction engine calculates arriving speed, remaining physical distance along the road network, and historical traffic indexes to predict arriving time dynamically.

Safety & Emergency

Emergency SOS Integration (100)

Our high-priority life safety feature designed to keep commuters safe during critical times.

One-Tap Dispatch

In critical situations, holding down the red floating SOS button for 2 seconds opens a physical dialer connected to the regional police emergency number (100).

Advanced Telemetry Logging

When clicked, the app sends an secure background request containing the incident timestamp, client IP address for precise spatial locating, and the active Bus ID (if triggered while tracking).

Network Hardening (Keepalive)

Using modern HTML5 keepalive parameters, we ensure that the network logs reach our databases even if the user immediately closes the browser or switches to the phone dialer app.

Core Features

Community Issue Reporting

Lodge real-time issues on overcrowding, delays, or broken amenities directly to administrators.

Automated Bus ID Passing

If you experience an issue on a specific bus, tapping 'Report' directly from that bus's tracking page pre-fills the Bus ID inside the form automatically so you don't have to memorize it.

Admin Review Portal

All community feedback is monitored on our advanced Administrator Dashboard. Admins inspect issue locations, review user descriptions, and have permissions to securely delete outdated feedback when resolved.

Getting Started

Progressive Web App (PWA) Install

Install the app directly on your mobile device or desktop for instant standalone access.

Home Screen Access

To experience full-screen standalone mode, tap the floating 'Install App' banner at the bottom of the home screen, or select 'Add to Home Screen' inside your web browser.

Offline Operation

The application caches key route details, localized texts, and UI layouts to ensure you can load the schedule and contact numbers even in areas with zero cellular reception.

Getting Started

Multi-Language Localization

Switch dynamically between English and Hindi with full local settings preservation.

Seamless Switching

Tap the language toggle in the top bar to translate the entire website instantly.

Persistent Preferences

Your language and customized font preferences are saved in your browser's persistent storage, ensuring you never have to reconfigure them on subsequent visits.

Frequently Asked Questions

Why is the live bus location not moving?

Buses update their positions every 10–20 seconds. If a bus remains static for longer, it may have stopped at a major bus stand or signal, or has temporarily lost cellular connection.

Does the SOS button call the police automatically?

For security, holding the SOS button triggers a quick background data dispatch to the admin logs and automatically loads '100' on your mobile dialer, requiring a single tap from you to confirm the call.

How do I log in to the administrator portal?

Navigate to the admin portal path. Enter your secure administrator token in the field to authenticate and gain access to the audit logs.