Add details for a new external service matrix

To allow the system to connect to the external matrix service, add basic information.

Enter basic matrix information

1. In the Details tab, add the matrix’s basic identity information:

   • Code: A unique short name or ID used by the system.

   • Description: A clear, descriptive name to help users recognize the matrix's purpose.

   • Matrix type: A dropdown menu to activate or deactivate the matrix. Available values ​​are:

     • F - full stereo: An array saves information about travel times and distance between each pair of two points

     • f - full mono: The array only saves information about travel times for each pair of points.

     • S - smart stereo: To save memory, the data structure compresses and saves information about travel times and distances.

     • s - smart mono: To save memory, the data structure compresses and saves information about travel times and distances.

     • Note: When no option is selected, the definition is saved but not operative. 

   • Integration type: Defines the service provider.

   • Vehicle type: Defines the type of vehicle used.

   • Bands: Activates the multiple time slot definition. 

     • See Activate bands.

   • Autonomy: Sets the maximum vehicle range (in seconds). 

     • The default value is infinite.

     • Any transfer that exceeds your set limit counts as infinite duration. 

   • Crow Speed (km/h): The speed that calculates travel time for disconnected points.

     • If not set, the system default behavior still considers disconnected points.

   • Crow Penalty Coefficient: High multipliers discourage the system from scheduling routes that don’t follow crow-flies logic.

     • Straight-line travel times have a multiplier of 1 (no penalty applied).

     • Higher multipliers indicate the route is further away from the ideal.

   • Crow Min Time (seconds): The system will never calculate a straight-line travel time lower than this safety floor value.

   • CrowSpeedFallBack (km/h): If the online service doesn’t respond and real-time data is unavailable, schedule based on approximate travel times.

     • The default value is null; 0 means unreachable.

   • Active: Define if the Online Matrix Definition is operative or not.

2. Click Save.

Activate bands

When you activate Bands (bands="true"), it triggers the "Cube" endpoint. This uses high-performance travel time predictions based on seven predefined traffic patterns:

• (0:00-6:30) - Night free flow

• (6:30-9:30) - Morning rush hour

• (9:30-11:30) - Morning travel pattern

• (11:30-14:00) - Midday travel pattern

• (14:00-16:00) - Afternoon travel pattern

• (16:00-20:00) - Evening rush hour

• (20:00-24:00) - Night free flow (same as first)

By declaring a space linked with an OnlineMatrix with bands="true" the Solvice cube endpoint is used.

XML Example

<onLineMatrix service="solvice" name="Auto" type="F" bands="true"
  baseUrl="https://routing.solvice.io">
  <apiKey value="xxx" />
  <configuration vehicleType="CAR"/>
</onLineMatrix>
<space matrix="Auto" />

Declaring a space linked with OnLineMatrix with bands="true" is the same as declaring a space like this:

<space matrix="Auto" name="Cube">
  <band end="00.01" matrix="Auto" start="06.30"/>
  <band end="06.31" matrix="Auto" start="09.30"/>
  <band end="09.31" matrix="Auto" start="11.30"/>
  <band end="11.31" matrix="Auto" start="14.00"/>
  <band end="14.01" matrix="Auto" start="16.00"/>
  <band end="16.01" matrix="Auto" start="20.00"/>
  <band end="20.01" matrix="Auto" start="00.00"/>
</space>

What’s next?

See Configure route calculation details for a new external service matrix.