0.27.0 Migration Guide

SEMVER breaks:

• Maps SDK 7.0 > please see their migration guide here
• New core location APIs > updated documentation here
• ☝️ both of these were updated in this PR

Using the new ReplayRouteLocationEngine:

• ReplayRouteLocationEngine was updated with the new LocationEngine API updates. To use it with MapboxNavigation now:

MapboxNavigation navigation = ...
DirectionsRoute routeToReplay = ...

ReplayRouteLocationEngine replayEngine = new ReplayRouteLocationEngine();
replayEngine.assign(routeToReplay);
      
navigation.setLocationEngine(replayEngine);
navigation.startNavigation(routeToReplay);

• NavigationView will still replay the given DirectionsRoute with NavigationViewOptions#simulateRoute(true)

PRs

• Set ssmlAnouncement when using SpeechAnnouncementListener

Using willVoice with NavigationView #1675:

We now pass a SpeechAnnouncement and ask for one in return. This is so you can take advantage of the ssmlAnnouncement field. Previously, with a String, parsing of the SSML was not possible.

Old:

@Override
public String willVoice(SpeechAnnouncement announcement) {
  return "All announcements will be the same.";
}

New:

@Override
public SpeechAnnouncement willVoice(SpeechAnnouncement announcement) {
  return SpeechAnnouncement.builder()
    .announcement("Announcement")
    .ssmlAnnouncement("SSML announcement")
    .build();
}