Configure distance providers (PC Miler and MileMaker)

Once your tenant is integrated with a distance provider, users with Admin-level permissions and above can configure and save your distance provider parameters within shipments, orders, customer accounts, and contracts. 

How distance provider rules work

Enabling distance provider parameters will override Turvo’s default mileage calculator and enable your distance provider, either PC Miler or MileMaker, as the mileage calculator for applicable shipments. If you do not input parameters, the distance provider will default to the Turvo mileage calculator. 

Your preferred distance provider configuration can be done at the shipment-level, order-level, customer account-level, or contract-level. 

  • Shipment-level configurations are used when calculating distance for all shipments that the configuration applies to. 
  • Order-level configurations are applied to all orders that the configuration applies to.
  • Customer account-level configurations are applied to all shipments and/or orders that the configuration applies to.
  • Contract-level configurations are specific to fuel, services, and accessorials on that contract. 

Note: If the rules for one level match the one above it, then no recalculation is done.

PC Miler and MileMaker support zip to zip based distance calculating on shipments and orders when the location specificity is set to zip to zip.

  • For all PC Miler versions, location zip codes are used to get the distance. If the zip code doesn’t exist, Turvo falls back to coordinates.
  • For MileMaker Guide 19 version, location zip codes are used to get the distance. If the zip code doesn’t exist, Turvo falls back to coordinates.
  • For MileMaker Guide 20, Turvo uses specific location coordinates to calculate distance.

How it impacts shipment information

Using an external distance provider can impact your shipment information in the following ways.

Sharing with partner tenants

Sharing of distance along with distance provider depends on the Applicable for setting, which has two values: Owned shipments and All shipments.

For example, you have PC Miler enabled as your distance provider and you work with two customers, Customer 1 and Customer 2.

  • Customer 1 uses MileMaker for TL shipments with Applicable for set to All shipments. If you create a shipment and share it with Customer 1, the distance gets recalculated based on MileMaker.
  • Customer 2 uses MileMaker for TL shipments with Applicable for set to Owned Shipments. If you create a shipment and share it with Customer 1, the distance is not recalculated with MileMaker. 
  • If a shipment on an owned tenant is different from a shared tenant, then the distance is always recalculated based on the shared tenant’s configuration. For example, you have a shipment with four stops, Customer 1 has two stops and Customer 2 has two stops. The distance is recalculated using MileMaker for each shared tenant. 

Updating shipments

If a shipment is updated in such a way that it falls under a different distance provider rule than it did before, then Turvo will recalculate the distance and update the shipment.

Impact on ETAs and drive time

ETAs are calculated based on the distance provider configured. 

How to integrate a distance provider with your tenant

Users with Owner, Admin, or Super Admin roles in your tenant, can configure an external distance provider for shipments. 

  1. From anywhere in Turvo, click your profile icon in the top right corner and select Admin console from the drop-down.


  2. Click the Settings card to open the tenant setting.
    2_-_Admin_console_tiles.png

  3. Click the Shipments section header, then click Distance Providers.


  4. Toggle ON PCMiler or MileMaker:
    1. PCMiler: enter the API Key
    2. MileMaker: enter the username and password

  5. Use the Mode drop-down to select the mode.


    Note: The PC Miler integration is available for the TL, LTL, and Drayage modes only. All other modes must use Turvo’s default distance provider.

  6. Use the Provider drop-down to select from Turvo, PC Miler, and MileMaker.


  7. Use the Applicable for drop-down to select from All shipments and Owned shipments.


    Owned shipments: The selected distance provider will only be used for the shipments created within your tenant that match the selected mode.

    All shipments: The selected distance provider will be used for shipments that match the selected mode, whether they are created within your tenant or shared to your tenant by a shipping provider.

    Note: If the shipment is shared to your tenant and the original tenant uses a different distance provider than yours, then the distance is recalculated for your tenant.

  8. Use the Profile drop-down to either select a profile or to create one.


  9. To create a profile, click + Add profile.


  10. Complete the fields in the Add profile modal.
    • The image below shows the options for PC Miler:
      2024-03-07_10-58-29.png
    • The image below shows the options for MileMaker:
      2024-03-07_10-59-53.png

      Note: The options between PC Miler and MileMaker will vary based on version.

  11. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates.

Once applied, the selected distance provider will calculate distance based on the parameters set for each mode’s rule. If a shipment is created that a rule does not apply to, that shipment will use the default Turvo distance provider.

How to configure customer order-level distance provider rules

To configure the distance provider on the order, follow the steps below:

  1. Navigate to Admin console > Settings > Orders and click Distance provider.

  2. Select PC Miler or MileMaker from the Provider drop-down.

  3. Select from All orders and Owned orders under the Applicable for drop-down.

  4. Select the profile under the Profile drop-down. If no profiles are set up, click + Add profile.

  5. In the Add profile window, name your profile and then use the fields to set up your profile and click Save to save your changes.
    Note: The options between PC Miler and MileMaker will vary based on version.

  6. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates. 

How to configure customer account-level distance provider rules

Shipment Distance Provider

You can also configure a specific distance provider for a specific customer. To configure the shipment distance provider on the customer account, follow the steps below:

  1. Navigate to Customer account > Details > Settings and click Shipment distance provider.

  2. Select the mode from the Mode drop-down.

  3. Select your distance provider from the Provider drop-down.

  4. Select from All shipments and Owned shipments under the Applicable for drop-down.

Order Distance Provider

To configure the order distance provider on the customer account, follow the steps below:

  1. Navigate to Customer account > Details > Settings and click Order distance provider.


  2. Select the mode from the Mode drop-down.

  3. Select your distance provider from the Provider drop-down.

  4. Select from All shipments and Owned shipments under the Applicable for drop-down.

Note: If no customer account-level distance provider settings are configured, Turvo uses the tenant-level settings. Additionally, if a shipment has more than one customer, Turvo checks to see if the provider profile is the same for both; if it is the same, Turvo uses the profile, and if it is different, Turvo uses the tenant-level settings.

Important note: When a shipment is created with a particular customer that has a distance provider setting, the same setting is used for distance calculations on the shipment even if the setting is later changed on the customer side. The updated distance provider setting reflects if anything on the customer block is updated for the shipment, or for any new shipments created for the customer, post the setting update. 

Updating the distance provider for contract cost types - freight, fuel, and accessorials

To configure the distance provider on the contract, follow the steps below:

  1. Navigate to Contract > Details and click Distance provider.

  2. Select from the options under the Cost Categories drop-down.
    • Note: You can multiselect from freight, fuel, and services.
  3. Select the mode from the Mode drop-down.

  4. Select PC Miler or MileMaker from the Provider drop-down.

  5. Select the profile under the Profile drop-down. If no profiles are set up, click + Add profile.

  6. In the Add profile window, name your profile and then use the fields to set up your profile and click Save to save your changes.
    Note: The options between PC Miler and MileMaker will vary based on version.

  7. Now that you have created a profile, it is available in the Profile drop-down. Select the profile and click Save to save your updates





Was this article helpful?

0 out of 0 found this helpful