1. Home
  2. Order Entry and Customers
  3. Mileage Calculator/Trip Optimizer

Mileage Calculator/Trip Optimizer

The mileage calculation feature allows a user to calculate a freight charge for an order, based on the mileage between the warehouse it will ship from and the customer’s ship to address on the order.

Enabling Mileage Calculation

In order to enable the mileage calculator, an account must be created with TomTom: https://developer.tomtom.com/store/maps-api 

Once registered with them, take the API Key that they provide, go to Company Preferences > Add Ons, and enter it into the TomTom Routing Integration.

Check the “Enable Mileage calculation” check box and select whether not to enable “Address Validation”.

Finally, this URL should be whitelisted on your network: https://api.tomtom.com

Address Validation

Address validation is used to correct small mistakes in the address that is entered on the customer. It will make changes things like “Av” to “Ave” or it may change “St” to “Ave”, depending on which is correct. When an address is validated, a message will appear and a green checkmark will be displayed beside the address:

If an address cannot be validated, a yellow exclamation point will be shown.

In rare cases, address validation may change an address even though it is correct. To keep an address from being changed, click the “Lock Address” check box.

This will display a lock symbol. Address validation can be disabled completely in the company preferences if needed.

Create Mileage Rates

Go to System > Company Preferences dropdown > Mileage Rates

Min Charge – This is the minimum amount the customer will be billed for freight at that rate.
Rate – The amount the customer will be charged per mile.
Sort – Determines what order the rates will show in the dropdown on the order form.
Rounding Level – The final freight charge will be rounded up to the next increment of this number.

Calculate Freight Charges

On an order, click on the ruler icon next to the freight field. This will calculate the distance for a one way trip, without factoring in traffic.

Choose the rate and click Accept.


To calculate the mileage on a trip, click the refresh button beside distance on the trip detail. This will calculate the distance and time for a round trip, without factoring in traffic.

To change the freight charge for an order on the trip info screen, click the button beside the current freight charge.

Then choose the new rate and click Accept.

Using Route Optimization

Route optimization utilizes the same TomTom integration as the Mileage calculator. To use it, open up a trip’s detail screen and click on “Optimize Stop Order”. Paradigm will then use TomTom to calculate the optimal route for the trip and automatically update the stop order.

Note: TomTom doesn’t take into account current traffic patterns when determining the best route. It will optimize the route to find the shortest mileage for commercial vehicles.

Related Articles