Release Notes

Version 0.37.0 - 14/11/2023

General

Breaking changes

  • Rename AdrTunnelRestrictionCodeProperty.option to AdrTunnelRestrictionCodeProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename AltitudeChangeEfficiencyProperty.option to AltitudeChangeEfficiencyProperty.id in package com.tomtom.sdk.vehicle.property.engine.
  • Rename AltitudeChangeEnergyProperty.option to AltitudeChangeEnergyProperty.id in package com.tomtom.sdk.vehicle.property.engine.combustion.
  • Rename AuxiliaryPowerProperty.option to AuxiliaryPowerProperty.id in package com.tomtom.sdk.vehicle.property.engine.combustion.
  • Rename AxleWeightProperty.option to AxleWeightProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename BatteryCurveProperty.option to BatteryCurveProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename ChargingConnectorsProperty.option to ChargingConnectorsProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename ChargingTimeOffsetProperty.option to ChargingTimeOffsetProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename CombustionEngineProperties.option to CombustionEngineProperties.id in package com.tomtom.sdk.vehicle.property.
  • Rename CommercialVehicleProperty to IsCommercialProperty in com.tomtom.sdk.vehicle.property.
  • Rename CommercialVehicleProperty.option to CommercialVehicleProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename CurrentChargeProperty.option to CurrentChargeProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename CurrentFuelProperty.option to CurrentFuelProperty.id in package com.tomtom.sdk.vehicle.property.engine.combustion.
  • Rename ElectricEngineProperties.option to ElectricEngineProperties.id in package com.tomtom.sdk.vehicle.property.
  • Rename FuelEnergyDensityProperty.option to FuelEnergyDensityProperty.id in package com.tomtom.sdk.vehicle.property.engine.combustion.
  • Rename HeightProperty.option to HeightProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename LengthProperty.option to LengthProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename LoadTypeProperty.option to LoadTypeProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename MaxChargeProperty.option to MaxChargeProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename MaxSpeedProperty.option to MaxSpeedProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename PropertyId.CommercialVehicle to PropertyId.IsCommercial in com.tomtom.sdk.vehicle.property.PropertyId.
  • Rename SpeedConsumptionProperty.option to SpeedConsumptionProperty.id in package com.tomtom.sdk.vehicle.property.engine.combustion.
  • Rename SpeedConsumptionProperty.option to SpeedConsumptionProperty.id in package com.tomtom.sdk.vehicle.property.engine.electric.
  • Rename VehicleUpdateOption to PropertyId in package com.tomtom.sdk.vehicle.
  • Rename vehicleUpdateOptions parameter to trackedProperties in addVehicleUpdatedListener method of DefaultVehicleProvider in package com.tomtom.sdk.vehicle.
  • Rename VelocityChangeEfficiencyProperty.option to VelocityChangeEfficiencyProperty.id in package com.tomtom.sdk.vehicle.property.engine.
  • Rename WeightProperty.option to WeightProperty.id in package com.tomtom.sdk.vehicle.property.
  • Rename WidthProperty.option to WidthProperty.id in package com.tomtom.sdk.vehicle.property.

Deprecations

  • Deprecate and replace decimal bytes units with binary ones. Do the following to adapt your project to these API changes:
    • Replace usage of the Memory.Unit.Kilobytes object with the Memory.Unit.Kibibytes.
    • Replace usage of the Memory.Unit.Megabytes object with the Memory.Unit.Mibibytes.
    • Replace usage of the Memory.Unit.Gigabytes object with the Memory.Unit.Gibibytes.
    • Replace usage of the Memory.inBytes() api with the Memory.inWholeBytes().
    • Replace usage of the Memory.inKilobytes() api with the Memory.inKibibytes().
    • Replace usage of the Memory.inMegabytes() api with the Memory.inMibibytes().
    • Replace usage of the Memory.inGigabytes() api with the Memory.inGibibytes().
    • Replace usage of the Memory.inWholeKilobytes() api with the Memory.inWholeKibibytes().
    • Replace usage of the Memory.inWholeMegabytes() api with the Memory.inWholeMibibytes().
    • Replace usage of the Memory.inWholeGigabytes() api with the Memory.inWholeGibibytes().
    • Replace usage of the Memory.bytes(value: Double) api with Memory.bytes(value: Long) or Memory.bytes(value: Int)
    • Replace usage of the Memory.kilobytes(value: Int) api with the Memory.kibibytes(value: Int).
    • Replace usage of the Memory.kilobytes(value: Long) api with the Memory.kibibytes(value: Long).
    • Replace usage of the Memory.kilobytes(value: Double) api with the Memory.kibibytes(value: Double).
    • Replace usage of the Memory.megabytes(value: Int) api with the Memory.mibibytes(value: Int).
    • Replace usage of the Memory.megabytes(value: Long) api with the Memory.mibibytes(value: Long).
    • Replace usage of the Memory.megabytes(value: Double) api with the Memory.mibibytes(value: Double).
    • Replace usage of the Memory.gigabytes(value: Int) api with the Memory.gibibytes(value: Int).
    • Replace usage of the Memory.gigabytes(value: Long) api with the Memory.gibibytes(value: Long).
    • Replace usage of the Memory.gigabytes(value: Double) api with the Memory.gibibytes(value: Double).
  • Deprecate the extension Result<R, L&gt;.toEither.

Map

Updates

  • com.tomtom.sdk.map.display.route.RouteSection is now available in General Availability.

Breaking changes

  • Rename com.tomtom.sdk.navigation.ui.NavigationUiOptions.units to com.tomtom.sdk.navigation.ui.NavigationUiOptions.unitSystemType.
  • Replace com.tomtom.sdk.common.measures.UnitSystem with com.tomtom.sdk.navigation.UnitSystemType in com.tomtom.sdk.navigation.ui.NavigationUiOptions.
  • Replace TomTomNavigation::acceptProposedRoute with TomTomNavigation::selectActiveRoute.

New Features

  • Add new route as active to the session when language is changed and inform integrator.
  • Introduce the ActiveRouteChangedListener to inform about the active route changes in the navigation session.
  • Introduce the RouteAddedListener to inform about new routes added to the navigation session.
  • Introduce the RouteRemovedListener to inform about routes removed from the navigation session.
  • Use Virtual Horizon to get location context information beyond driver's visible horizon. A guide for how to retrieve horizon data has been made available in our Nav SDK documentation.

Fixes

  • Display 'Fixed Speed Camera' type correctly.

Updates

  • Com.tomtom.sdk.navigation.TomTomNavigation.language is now available in General Availability.
  • Com.tomtom.sdk.navigation.TomTomNavigation.preferredLanguage is now available in General Availability.
  • Com.tomtom.sdk.navigation.TomTomNavigation.unitSystem is now available in General Availability.
  • Add parcelable support to com.tomtom.sdk.navigation.UnitSystemType.
  • Change default guidance engine to DynamicGuidanceEngine.
  • Copy the description of inherited properties from GuidanceInstruction.
  • Log necessary information about navigation's configuration.

Routing

New Features

  • Separate avoid tolls and vignettes.

Fixes

  • LDEV now supports replanning after deviation.

Updates

  • Allow requesting a route without instructions.

Breaking changes

  • Make toPlace in Search UI internal.
  • Move Poi, PoiCategory, CategoryId, OpeningHours, OpeningHoursMode, ChargingPark, PoiId, Source, StandardCategoryId classes from Search to Location. And move FuelType to Vehicle. Move or rename com.tomtom.sdk.search.model.poi.Poi to com.tomtom.sdk.location.poi.Poi Move or rename com.tomtom.sdk.search.model.poi.PoiId to com.tomtom.sdk.location.poi.PoiId Move or rename com.tomtom.sdk.search.model.result.Source to com.tomtom.sdk.location.poi.Source Move or rename com.tomtom.sdk.search.model.poi.PoiCategory to com.tomtom.sdk.location.poi.PoiCategory Move or rename com.tomtom.sdk.search.model.poi.CategoryId to com.tomtom.sdk.location.poi.CategoryId Move or rename com.tomtom.sdk.search.model.poi.StandardCategoryId to com.tomtom.sdk.location.poi.StandardCategoryId Move or rename com.tomtom.sdk.search.model.poi.Brand to com.tomtom.sdk.location.poi.Brand Move or rename com.tomtom.sdk.search.model.time.OpeningHours to com.tomtom.sdk.location.poi.time.OpeningHours Move or rename com.tomtom.sdk.search.model.time.OpeningHoursMode to com.tomtom.sdk.location.poi.time.OpeningHoursMode Move or rename com.tomtom.sdk.search.model.fuel.FuelType to com.tomtom.sdk.vehicle.FuelType

Fixes

  • Make search find streets and addresses when searched along with a search area.
  • Use proper timezone for custom POI in the offline search engine.

Updates

  • Remove annotation which is not in use anymore.
    • The ExperimentalHybridReverseGeocoderApi annotation is not needed anymore, the API is already in GA

Traffic

Updates

  • Added new TrafficClient implementation.