Types of garage Kms and hrs calculation logics and how to configure it

What are Garage Kilometers?

Garage Kilometers (Garage Kms) are the kilometers a vehicle drives when it travels from the garage to the first pickup point, and from the final drop-off point back to the garage.

What are Garage Hours?

Garage Hours (Garage hr’s) are the Hours a vehicle drives when it travels from the garage to the first pickup point, and from the final drop-off point back to the garage.

There are 4 different flavours in calculating the garage km’s and garage hr’s for billing. 

The 4 Ways to Calculate Garage Kms and Garage hr’s for Billing

Depending on what is agreed in the contract, the billing team uses one of these four methods to count the Garage kilometers and Garage hours

1. Vendor Garage Geocodes

In this method, the exact GPS coordinates (geocodes) of the vendor's physical garage are saved in our backend system. Based on that configuration, the system automatically calculates the garage kilometers by measuring the distance from the garage to the pickup location, and again from the final drop-off location back to the garage. 

Example Scenario

• The Setup: The vendor's garage location is configured in our system at HSR Layout, 27th Main Road.

• The Trip: A cab is booked with the pickup location at Electronic City Bus Stop and the final drop location at the Kempegowda Airport.

How the Garage Kms and hr’s are Calculated:

The system simply adds the two empty trips together: (HSR Layout Garage to Electronic City Pickup) + (Airport Final Drop back to HSR Layout Garage).

For hours these will be configured in the system and the same will be calculated. 

How to Enable this ? 

For Garage km’s 

Open pms/ consul then go to billingAndGarageConfig and search for  garageCalculationFactors and then enable the required km’s as below. Just change the below number 0 into required km’s in number. 

"applyStartGarageKM": 0,

            "applyEndGarageKM": 0,

Also make sure the below is also configured as 1then only above config will work. If it is kept 0 it means the feature is disabled.

  "applySameGarageKMRate": 1

For Garage hr’s 

Open pms/ consul then go to billingAndGarageConfig and then search for garageCalculationFactors and then enable the required km’s as below. Just change the below number 0 into required hr’s in number. 

"applyStartGarageHours": 0,

 "applyEndGarageHours": 0,

Also make sure the below is also configured as 1  then only above config will work. If it is kept 0 it means the feature is disabled.

  "applySameGarageHourRate": 1 

2. Fixed Garage Km & Hr

In this method, we configure a fixed number of kilometers in our backend system for both the start garage to pickup location and the drop location to end garage. Instead of using the actual distance driven, the system always uses these fixed, agreed-upon numbers to calculate the garage kilometers and hours for billing.

Example Scenario

• The Reality: A cab travels 20 km from the garage to the pickup point, and 2 km from the drop off point back to the garage. (Actual total = 22 km).

• The System Setup: In the backend, the fixed garage distance is configured as 5 km for the way there and 5 km for the way back.

How the Garage Kms are Calculated: 

The system ignores the real distances (20 km and 2 km) and simply adds the fixed numbers together: (5 km fixed start) + (5 km fixed end) = 10 total garage kilometers.

For hours these will be configured in the system and the same will be calculated. 

How to enable this ? 

For Garage km’s 

Open pms/ consul then go to billingAndGarageConfig and search for  garageCalculationFactors and then enable the required km’s as below. Just change the below number 0 into required km’s in number. 

  "fixedPreTripKM": 0,

 "fixedPostTripKM": 0,

Also make sure the below is also configured as 1then only above config will work. If it is kept 0 it means the feature is disabled.

"applyFixedPreTripKM": 1,

"applyFixedPostTripKM": 1,

  "applySameGarageKMRate": 1

For Garage hr’s 

Open pms/ consul then go to billingAndGarageConfig and then search for garageCalculationFactors and then enable the required hr’s as below. Just change the below number 0 into required hr’s in number. 

"fixedPreTripHours": 0,

"fixedPostTripHours": 0,

Also make sure the below is also configured as 1  then only above config will work. If it is kept 0 it means the feature is disabled.

"applyFixedPreTripHours": 1,

 "applyFixedPostTripHours": 1,

 "applySameGarageHourRate": 1 

3. ETS Trip Empty Leg

In this method, we don't configure any fixed garage coordinates in our system. Instead, the garage kilometers are calculated based on the exact geocodes traveled between the start garage to the pickup location and from the drop location to the end garage. The system tracks these geocodes using live GPS, and Google Maps calculates the actual distance for billing.

Example Scenario

• The Setup: No garage location is pre-set. The system relies entirely on GPS tracking and Google Maps routes.

• The Trip: * The vehicle travels from the start garage to the pickup location, which is 8 km away according to the Google Maps route.After the drop, the vehicle travels from the drop location back to the end garage, which is 24 km away according to the geocodes calculated by Google Maps.

How the Garage Kms are Calculated: The system simply adds the two GPS-tracked distances together: (8 km from start garage to pickup) + (24 km from drop to end garage) = 32 total garage kilometers.

For hours system will consider the exact time taken to cover these garage kms at that particular trip these will be picked from google maps data itself. 

How to enable this ? 

For Garage km’s 

Open pms/ consul then go to billingAndGarageConfig and search for  garageCalculationFactors and then enable the  below.

  "preTripEmptyLegKMFactor": 1,

            "postTripEmptyLegKMFactor": 1

  "applySameGarageKMRate": 1

Make sure the above value is 1 only if it is kept as 0 that means the feature is disabled. 

For Garage hr’s 

Open pms/ consul then go to billingAndGarageConfig and then search for garageCalculationFactors and then enable the below.

"preReportingEmptyLegHoursFactor": 1,

            "postTripEmptyLegHoursFactor": 1

 "applySameGarageHourRate": 1 

4. Cab Registration Garage Geocodes

In this method, the garage kilometers are calculated based on the specific garage where the cab/vehicle is officially registered in our system. We configure the geocodes for that particular registered garage in the backend. No matter where the cab actually starts its day, the system will always calculate the garage kilometers as the distance from its officially registered garage to the pickup location, and from the final drop location back to that same registered garage.

Example Scenario

• The Setup: A cab is officially registered at a garage located in Electronic City Phase 2, 2nd Cross Road, and this address is configured in the system.

• The Actual Movement: On the day of the trip, the cab happens to be physically parked at HSR Layout and drives from there to the pickup.

• The Trip: The pickup is at Majestic and the final drop-off location is at Whitefield.

How the Garage Kms are Calculated:

The system completely ignores the fact that the cab started from HSR Layout. Instead, it uses the registered address and calculates the billing like this:

1. The Way There (Start Garage Km): Calculated from the registered garage at Electronic City Phase 2 to the pickup at Majestic (Let's say this is 25 km).

2. The Way Back (End Garage Km): Calculated from the final drop at Whitefield back to the registered garage at Electronic City Phase 2 (Let's say this is 30 km).

Total Garage Kms Billed: The system simply adds these two fixed-route distances together: 25 km + 30 km = 55 total garage kilometers.

For hours these will be configured in the system and the same will be calculated. 

How to enable ? 

For Garage km’s 

Open pms/ consul then go to miscellaneous and search for  "calculateGarageKMS": true,

Mark it as true if the feature is needed and mark it as false to be disabled. 

This will be enabled only for Garage km’s but not for Garage hr’s.