Developer

Release Notes

Version 0.35.0 - 31/10/2023

Check the API Reference

General

Breaking changes

  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegion is no longer a data class.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionGraph is no longer a data class.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionId.value property is no longer a public one.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionOperation is no longer a data class.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionState is no longer a data class.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionStatesData is no longer a data class.
  • The com.tomtom.sdk.datamanagement.nds.update.compositeregion.CurrentCompositeRegionOperation is no longer a data class.

Fixes

  • Fixed increase in apk size due to number of dependencies.
  • Remove superfluous closing brace from `NdsStore.create.
  • Resolve a MissingResourceException when trying to use online safety locations with the horizon engine.

Updates

  • Add nanodegrees unit to Angle and Angle getter to GeoPoint.
  • Improve kdoc for the various ConnectorType values.
  • Log RuntimeFeature toggle changes.
  • Mark all experimental API annotation class Experimental*Api as experimental.

Map

New Features

  • Add the ability to set POI click listener for the ones found through Search feature.
  • Extend SearchConfiguration API from Search visualization module.
  • Implement setting style in premium map display.
  • Introduce the Elastic Data Provider API for map visualization.
  • Simple route visualization in premium map display.

Fixes

  • Fix crash in premium map display when trying to access protobuf messages.
  • Fix maneuver arrows.

Updates

  • Add component tests for the com.tomtom.sdk.map.display.map.
  • Move the NavigationEventDispatcher and FollowCameraConfiguration to public preview.
  • Promote to GA: RouteOptions class with all the fields: - geometry: List<geopoint> - color: Int - outlineWidth: Double - widths: List<widthbyzoom> - visible: Boolean - progress: Distance - instructions: List<instruction> - tag: String? - departureMarkerVisible: Boolean - destinationMarkerVisible: Boolean - isFollowable: Boolean - routeOffset: List<distance> - sections: List<routesection> - departureMarkerPinImage: Image? - destinationMarkerPinImage: Image? - departure: GeoPoint? - destination: GeoPoint? RouteSection class with all the fields: - type: RouteSectionType - indexRange: IntRange - textureUri: Uri?

Navigation

Breaking changes

  • Introduce com.tomtom.sdk.navigation.TomTomNavigation.preferredLanguage property for updating current navigation language.
  • Make com.tomtom.sdk.navigation.TomTomNavigation.language property read only.
  • Remove com.tomtom.sdk.navigation.NavigationHistorySnapshot class.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode parameter from the com.tomtom.sdk.navigation.TomTomNavigationFactory factory method.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode property from the com.tomtom.sdk.navigation.hybrid.Configuration.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode property from the com.tomtom.sdk.navigation.offline.Configuration.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode property from the com.tomtom.sdk.navigation.offroad.Configuration.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode property from the com.tomtom.sdk.navigation.online.Configuration.
  • Remove com.tomtom.sdk.navigation.replanning.MaintainRoutesMode.
  • Rename com.tomtom.sdk.navigation.TomTomNavigation.markWaypointAsVisited.
  • Revise persistent cache configuration parameters.
  • The com.tomtom.sdk.datamanagement.navigationtile.NavigationTileStoreConfiguration is no longer a data class.
  • Use common safety location data in horizon adapter.

New Features

  • Introduce com.tomtom.sdk.navigation.TomTomNavigation.deviationReplanningMode property for updating current deviation replannig mode.
  • Introduce a new API NdsStore.findRegionsAlongPolyline.

Fixes

  • "Build a navigation app" use case tutorial invokes navigation start on route click only if navigation is not already running.
  • Call start and shutdown for mock tile server.
  • Crash in TomTomNavigation.stop.
  • Fix crash in traffic module due to missing method.
  • Improvement in native pointer handling.

Updates

  • "Build a navigation app" renamed to "Building a navigation app".
  • Com.tomtom.sdk.navigation.DestinationArrivalListener is now available in General Availability.
  • Com.tomtom.sdk.navigation.TomTomNavigation.addDestinationArrivalListener.
  • Com.tomtom.sdk.navigation.TomTomNavigation.departFromWaypoint.
  • Com.tomtom.sdk.navigation.TomTomNavigation.removeDestinationArrivalListener.
  • Com.tomtom.sdk.navigation.WaypointArrivalListener is now available in General Availability.
  • Move Artifactory instructions from the project setup guide.
  • NavigationOptions is now in General Availability.
  • Prefetch navigation tiles along the active route. Prefetching affects data consumption (downloading tiles) from the cloud when route is activated
  • Promote com.tomtom.sdk.navigation.TomTomNavigation.addWaypointArrivalListener.
  • Promote com.tomtom.sdk.navigation.TomTomNavigation.removeWaypointArrivalListener.
  • RoutePlan is now in General Availability.
  • Use common safety location data in SafetyLocations.

Routing

Breaking changes

  • Make RangeCalculationOptions a normal class.
  • Remove copy function from RoutePoint.
  • Rename com.tomtom.sdk.routing.route.section.traffic.MagnitudeOfDelay.UNDEFINED to INDEFINITE.

Deprecations

  • Deprecate copy.
  • Deprecate extension function RoutePoint.angleTo.
  • Deprecate extension function RoutePoint.distanceTo.

New Features

  • Toll cost indication.

Updates

  • Add information about charging stops to EV routes doc.
  • Add unsupported route planning options to EV routing documentation.
  • Com.tomtom.sdk.routing.route.RoutePoint is now available in General Availability.
  • Convert CarpoolSection data class to normal class.
  • Convert CarTrainSection data class to normal class.
  • Convert CountrySection data class to normal class.
  • Convert FerrySection data class to normal class.
  • Convert LaneSection data class to normal class.
  • Convert LowEmissionZoneSection data class to normal class.
  • Convert MotorwaySection data class to normal class.
  • Convert PedestrianSection data class to normal class.
  • Convert RoadShieldSection data class to normal class.
  • Convert TollRoadSection data class to normal class.
  • Convert TollVignetteSection data class to normal class.
  • Convert TrafficSection data class to normal class.
  • Convert TunnelSection data class to normal class.
  • Convert UnpavedSection data class to normal class.
  • Convert UrbanSection data class to normal class.
  • Convert VehicleRestrictedSection data class to normal class.
  • Document Orbis unsupported options.
  • Improve range documentation comments.
  • Improve resilience to changes in Routing Service.
  • Promote com.tomtom.sdk.routing.options.calculation.ArrivalSidePreference to GA.
  • Promote com.tomtom.sdk.routing.options.RoutePlanningOptions.arrivalSidePreference to GA.
  • Promote com.tomtom.sdk.routing.route.section.traffic.SimpleCategory to GA.
  • Property Route.destination is now available in General Availability.
  • Property Route.geometry is now available in General Availability.
  • Property Route.origin is now available in General Availability.
  • Property Route.planningReason is now available in General Availability.
  • Property Route.routePoints is now available in General Availability.
  • Property Route.waypoints is now available in General Availability.

Search

Breaking changes

  • Module: search:structured-search-client-onboard. Removed package com.tomtom.sdk.search.structuredsearch.offline.domain [RemovedPackage]

Deprecations

  • Deprecate the SearchOptions constructor for a search request containing maxDetourDuration. Use the SearchOptions constructor for a search request which doesn't contain maxDetourDuration instead. Do the following to adapt your project to these API changes:
  • Remove all usage of maxDetourDuration for a search request
  • Use the constructor for a search along the route request if maxDetourDuration needs to be set

Fixes

  • Add missing tests for recents, improve deduplication logic.
  • Ignore coordinate search results outside of the onboard map coverage area, as these results are not usable.
  • Make offline results not mix the online search results when searched with personal locations.
  • Return a single search result for the coordinate search.
  • Revert fix for returning a single search result for the coordinate search. Need to handle query intents in a holistic way.

Updates

  • Move experimental standard category IDs to GA.
  • Use common tests for personal locations and custom POIs.