distanceToDestination meaning

What is the meaning of Activity.Info.distanceToDestination?

According to the documentation it's "The distance to the destination in meters (m)." which made me think that totalDistance = elapsedDistance + distanceToDestination, but in the simulator (SDK 7.1.1, edge840) whatever I set in Simulation > Set Navigation Data > Distance To (m) will be returned in distanceToDestination all the time. I thought that as elapsedDistance increases the distanceToDestination will decrease.

Is this a misunderstanding from my part of what's the meaning of distanceToDestination or a misunderstanding of how the simulator works or is it a bug in the edge840 simulator?

  • I've not checked, but this distance could be "as the crow flies" and not based on the route.

    Distance between your current location and the location at the end.

  • I don't think so, because when I load a 10k course that starts and ends 40+km from here it gives me the correct 10000m. But I'll try to see how it behaves when I get outside and start an activity...

    However if you haven't checked it then how do you know that it means current location to destination? Is it based on the documentation only or experience using distanceToDestination?

  • It is definitely the remaining distance to destination in meters. This feature works on real device but not in simulator. In simulator it stays the value for the totalDistance. 

    Note for Edge x40 devices: when leaving the course (offcourse) the distance to destination becomes null, when find the course again, it continues to work.

    Maybe it does not work in simulator, because the sim has no map. The distance to destination is not simply the course distance minus elapsed distance! On real device it is calculated based on loaded course, your position and the remaining course from that point.