FAQs

Frequently Asked Questions

How does the Reachable Range service handle live traffic information?

The service integrates live traffic into its calculations, so the reachable area dynamically reflects current congestion and road conditions. This ensures that the returned range is based on the most up-to-date travel speeds across the road network. The behavior can be controlled using the traffic parameter.

What does ‘Engine error while executing route request: STOPPED’ mean?

Requests are forcefully canceled once they exceed an internal compute time limit (currently around 30 seconds) in order to avoid resource starvation scenarios. In this case, the service returns the following error response:

1
{
2
  "formatVersion": "0.0.12",
3
  "detailedError": {
4
    "message": "Engine error while executing route request: STOPPED: The request exceeded the internal compute time limit and was canceled. For more information, go to: https://developer.tomtom.com/knowledgebase/apis/faq/routing/a-request-was-canceled-or-the-response-time-is-long-how-can-i-reduce-the-response-time/",
5
    "code": "COMPUTE_TIME_LIMIT_EXCEEDED"
6
  }
7
}

The message refers to a “route request” because the Reachable Range service runs on the same routing engine; the same compute time limit applies to reachable range requests. If you encounter this error, see the next question for ways to reduce the response time.

A request was canceled, or the response time is long. How can I reduce the response time?

The size of the resulting area for a reachable range calculation has the largest direct impact on the time it takes to compute it.

In addition, most range options have some impact on compute time. The default options produce fast responses. Using non-default options typically increases the response time.

The following options have a big impact on the response time:

• any avoid options, in particular, motorways, tollRoads, and ferries
• routeType options thrilling, shortest, and short
• vehicleMaxSpeed less than 60
• large timeBudgetInSec or distanceBudgetInMeters
• overly efficient vehicle models with a large ratio between fuelBudgetInLiters or energyBudgetInkWh and the respective consumption per distance