This release, 8.8, was made on 1st February 2024 and is based on commit 8.7-304-gf1fb8f68d in the Git repository. There are no source incompatibilities with 8.6. The main change is that re-routing is now done by a background thread during navigation, allowing applications to remain responsive.
The previous release, 8.6, was made on 8th August 2023 and was based on commit 8.6-1-gc0939f76f in the Git repository.
BACKGROUND ROUTE CALCULATION
Routes may now optionally be calculated in a separate thread, both at the start of navigation and during navigation. There is a new framework function to support this feature: StartNavigationDeferred starts navigation while triggering route calculation in a background thread. The user can check the navigation status in the same polling function that supplies a position fix, and display the new route when it is available. During turn-by-turn navigation, whether or not routing was started by StartNavigation or StartNavigationDeferred, if the position is off the route for more than the chosen time, or further from the route than the chosen maximum distance, a new route is calculated by a background thread. The function SetNavigationAutoReRoute has been removed because re-routing is now always automatic.
The navigation states ReRouteNeeded and ReRouteDone have been replaced by the states Routing, meaning that a route is being calculated, and NewRoute, meaning that a new route has just been calculated.
Routes are now calculated asynchronously in both the Maps App and the Windows demo.
LABELLING CHANGES
Labels are no longer condensed (shrunk horizontally) as part of the label fitting system. This feature has been removed, partly because it caused an inconsistent appearance where large numbers of small labels such as house numbers were drawn close together.
The standard style sheet now splits labels containing a slash ('/') into tokens and uses the first token as the main name and the second token as an alternative name, shown on a new line. Label formats in style sheets can extract labels using a new string operation that uses subscript syntax. For example, the expression ($[1]["/"]) extracts token 1 (tokens are numbered from zero, so this is the second token) from the standard name, referenced as $, using slash '/' as a delimiter. The first subscript is the token number and the second is a string containing delimiters. Tokens are stripped of leading and trailing whitespace.
NEW ERROR CODES
There are three new error codes. Here are the C++ versions. Versions in other APIs have similar names.
constexpr Result KErrorNoRouteData = 68; // no route data is available
constexpr Result KErrorTooManyFontsInStyleSheet = 69; // too many fonts are used in a style sheet (more than 1023)
constexpr Result KErrorTooManyBoxStylesInStyleSheet = 70; // Too many box styles are used in a style sheet (more than 1023)
SPECIFIC C++ SDK CHANGES
One overload of Framework::SetStyleSheet now takes a StringDictionary containing the style sheet variables, not a VariableDictionary.
The function Framework::StyleSheetVariables now returns a StringDictionary instead of a VariableDictionary.
A new function, Result Framework::StartNavigationDeferred(const RouteCoordSet& aCoordSet) allows navigation to start while calculating the route in a background thread.
A new function, Result Framework::DisplayNewRoute(), draws the new route if it has been created asynchronously during navigation.
The function void Framework::SetNavigationAutoReRoute(bool aAutoReRoute) and the data member NavigatorParam::AutoReRoute have been removed. Re-routing is now always automatic.
A new function, String Token(size_t aIndex,const MString* aSeparators = nullptr,const MString* aSingleCharacterTokens = nullptr) const returns a token from a string, specified by its index.
SPECIFIC .NET AND UWP SDK CHANGES
The properties Framework.NavigationAutoReRoute and NavigatorParam.AutoReRoute have been removed. Re-routing is now always automatic.
A new function, Result Framework.StartNavigationDeferred(RouteCoordSet^ aCoordSet) allows navigation to start while calculating the route in a background thread.
SPECIFIC ANDROID SDK CHANGES
A new function, int Framework.startNavigationDeferred(RouteCoordSet aCoordSet) allows navigation to start while calculating the route in a background thread.
The function void Framework.setNavigatorAutoReRoute(boolean aAutoReRoute) has been removed. Re-routing is now always automatic.
SPECIFIC IOS SDK CHANGES
A new CartoTypeFramework function, startNavigationDeferred, allows navigation to start while calculating the route in a background thread.
The CartoTypeFramework property navigationAutoReRoute and the CartoTypeNavigatorParam property autoReRoute have been removed. Re-routing is now always automatic.
