Skip to main content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.0] - 2026-02-19​

Added​

  • Track Recorder System

    • Recorder - Core recording service for GPS tracks with start/stop/pause/resume functionality, plus audio recording support.
    • RecorderConfiguration - Configuration options for recording sessions (data types, storage, continuous recording, video quality, etc.).
    • RecorderBookmarks - Bookmark management for recordings with import/export, protect, delete, and list capabilities.
    • ActivityRecord - Representation of recorded activities.
    • LogMetadata - Metadata for recorded logs (timestamps, durations, coordinates, active types, metrics).
    • LogMetrics, RecordMetrics - Recording metrics and statistics.
    • SoundMark, TextMark, LogMark - Mark types for annotating recordings at specific timestamps.

  • Sound Playing Service

    • SoundPlayingService - Service for managing audio playback (play text, play sound, cancel sounds).
    • SoundPlayingPreferences - Audio playback preferences and settings.
    • SoundPlayingListener - Event listener for audio playback events (start, stop, interruption, volume change).
    • SoundSessionRequestPreferences - Preferences for sound session requests.

  • Map Details & Terrain

    • MapDetails - Comprehensive static map information (coverage, providers, capabilities, country code/name, sunrise/sunset, etc.).
    • CountryData - Representation of country-specific data.
    • BuildTerrainProfile - Terrain profile building.

  • Vehicle Profiles

    • EVProfile - Electric Vehicle profile with support for battery capacity, health, departure/destination SOC, and connectors.
    • BikeProfileElectricBikeProfile & ElectricBikeProfile - Electric bike routing profiles.
    • MotorVehicleProfile, CarProfile, TruckProfile - Extended profile classes for detailed vehicle routing.

  • Navigation & Routing Enhancements

    • RoutePreferences Expansion: Added extensive getters/setters for routing configurations, including:
      • Accurate waypoints approach & track matching.
      • Profiles integration (bikeProfile, carProfile, truckProfile, pedestrianProfile).
      • Avoidance settings (ferries, motorways, toll roads, unpaved roads, traffic).
      • Public transport algorithm types and alternative route sorting.
    • RoundTripParameters - Parameters for round-trip route calculation.
    • DepartureHeading - Vehicle departure heading parameters.
    • VehicleRegistration - Vehicle registration data encapsulation.
    • PositionQualityExtension - Position quality extension for retrieving quality by ID.

  • View & Map API Enhancements (GemView/Core)

    • Viewport helpers: viewportF, viewportCenter properties.
    • Cursor & Selection: cursorWgsPosition property, plus helper methods cursorSelectionTrafficEvents(), cursorSelectionPath(), cursorSelectionMapSceneObject().
    • Camera & Movement: isAnimationInProgress, isCameraMoving properties.
    • Follow Position: getIsFollowingPosition() with alsoFlyToPosition parameter.
    • Zoom Control: minZoomLevel (getter/setter), maxZoomLevel (setter).
    • Camera/Terrain Accessors: mapAngle, viewAngle, hasTerrainTopography properties, and getAltitude() method.
    • Routing Helpers: clearRouteInstruction() method.
    • Rendering & Clipping: isRenderEnabled (getter/setter) and setClippingArea() method.
    • Callbacks & Listeners: Registration methods for map styles, cursor selection (paths, objects), and hovered map labels (landmarks, overlay items, traffic events).
    • Data Providers: getTransferStatistics() method with ServiceGroupType parameter.

Fixed​

  • Event conversion logic for TrafficEventList, Path, and MapSceneObject in event handlers.
  • Proper null handling for cursor selection methods (now explicitly returning null when no object is selected).
  • Missing hovered traffic event callback registration.
  • Text to speech instruction now receives the instruction text as a parameter in the callback.

[1.0.0] - 2026-02-06​

Added​

  • Initial release of Magic Lane Maps SDK for TypeScript
  • Core mapping functionality
  • Image handling utilities
  • Geographic area support
  • Coordinate system support

Roadmap​

The following features are planned for future releases:

FeatureAPIDescription
Multi-touch gestures-Pinch, rotate, tilt gestures for enhanced map interaction
Track RecorderRecorderCore recording service for GPS tracks
RecorderConfigurationConfiguration options for recording sessions
ActivityRecordRepresentation of recorded activities
Metrics, LogMetrics, RecordMetricsRecording metrics and statistics
RecorderBookmarksBookmark management for recordings
LogMetadataMetadata for recorded logs
LogMark, SoundMark, TextMarkMark types for annotating recordings
RecorderStatus, FileSortOrder, FileSortType, FileType, RecordingTransportModeEnums
Sound Playing ServiceSoundPlayingServiceService for managing audio playback
SoundPlayingPreferencesAudio playback preferences and settings
SoundPlayingListenerEvent listener for audio playback events
SoundPlayTypeTypes of sounds that can be played
Last updated on