PC Miler — Configurable Routing and Mileage Options
The PC Miler integration supports configurable routing and mileage parameters at the organization level. Your organization can define how PC Miler calculates mileage by choosing the routing type that best fits your operation and, optionally, controlling other calculation parameters such as vehicle type, toll road preferences, and more. These settings apply everywhere PC Miler is used in the TMS — shipment mileage lookups, rating and tariff calculations, and mileage-based reporting.
PC Miler must be configured as an Integration Source in the TMS meani. Settings are applied at the organization level by an admin.
How it works
Parameters are added as Integration Source Settings using the following naming pattern:
MileageReport_{ParameterName} = {Value}
For example, to set the routing type to Fastest:
Setting Name: MileageReport_RouteType
Setting Value: Fastest
When PC Miler is called, the TMS automatically detects any settings that follow this pattern and passes them directly to the PC Miler API. Multiple parameters can be active at the same time — all will be included in each request.
Routing Type Options
The most commonly configured parameter is MileageReport_RouteType, which controls how PC Miler selects a route between stops.
| Setting value | What it does |
|---|---|
| Practical | Routes based on commonly used roads, balancing distance and ease of travel. This is the default if no routing type is configured. |
| Shortest | Routes based on the shortest total distance, regardless of road type or travel time. |
| Fastest | Routes based on the fastest estimated travel time. |
Additional Configurable Parameters
Beyond routing type, any parameter supported by the PC Miler Route Reports API can be configured using the same MileageReport_{ParameterName} pattern. Below are the most commonly used options:
| Setting name | Available values | What it controls |
|---|---|---|
MileageReport_RouteType |
Practical, Shortest, Fastest | How the route between stops is selected. |
MileageReport_VehicleType |
Truck, Light, Auto | The type of vehicle used for routing calculations. Affects road restrictions and route selection. |
MileageReport_TollRoads |
Always, AvoidWhenPossible, None | Whether toll roads are used, avoided where possible, or excluded entirely. |
MileageReport_HighwayOnly |
true, false | When set to true, routing is restricted to highways only. |
MileageReport_BordersOpen |
true, false | Controls whether international border crossings are included in routing. Relevant for cross-border shipments. |
The full list of supported parameters is available in the PC Miler Route Reports API documentation. Any parameter listed there can be configured using the MileageReport_{ParameterName} pattern — no additional development work is required.
Example configuration
An organization that wants to route by fastest travel time, restrict to trucks, and avoid toll roads where possible would configure the following Integration Source Settings:
| Setting name | Setting value |
|---|---|
MileageReport_RouteType |
Fastest |
MileageReport_VehicleType |
Truck |
MileageReport_TollRoads |
AvoidWhenPossible |
All three parameters would be passed to PC Miler in every mileage request for that organization.
Where these settings apply
Once configured, the parameters apply to all PC Miler mileage calculations in your TMS:
- Shipment mileage lookups
- Rating and tariff mileage calculations
- Mileage-based reporting
Default behavior
If no MileageReport_RouteType setting is configured, PC Miler uses Practical routing by default. All other PC Miler defaults also remain in effect for any parameter not explicitly set.