dynamic_maps_engine 0.0.17

A plug-and-play Flutter map engine powered by Google Maps with smooth marker animation and ETA.

0.0.17

• feat: Improve map camera UX by retaining manual zoom level and adding a 10-second manual mode when gesture is detected to prevent jarring auto-centers.
• fix: Add retry mechanism to route calculation to handle temporary network instability instead of immediately returning a straight-line fallback route.
• fix: Update followUser camera tracking to properly support custom zoom levels and smoother rotation matching the user's heading.

0.0.16

• fix: Fix rerouting logic to use raw GPS position instead of snapped marker position, resolving issue where users were not rerouted when leaving the path.
• fix: Allow rerouting for stationary users if they are significantly off-route (e.g., stopping by the roadside after missing a turn).

0.0.15

• fix: Fix Chinese voice grammar format by correctly restructuring direction instructions (e.g. "Turn left onto [Street]" -> "向 [Street] 左转") so that street names are properly announced.
• fix: Remove redundant 'onto' to '向' replacement fallback in Chinese translation to prevent duplicate prepositions.

0.0.14

• fix: Fix alternative route polylines not rendering by resolving race condition during initial route selection.
• fix: Wrap alternative route marker rendering in try-catch to prevent canvas exceptions.
• fix: Limit minimum speed threshold for ETA calculation to avoid extremely high values from GPS drift while stationary.
• feat: Add option to hide simulation/demo button based on developer mode configuration.

0.0.13

• docs: Update Location Interval 5s.

0.0.12

• docs: Replaced raw image URLs with Giphy iframe embed codes for preview animations.

0.0.11

• docs: Replaced local assets/ GitHub URLs with Giphy media URLs to resolve pub.dev rendering issues without bloating the package size.
• docs: Removed local assets/ directory.
• docs: Updated Quick Start example class name to be more generic.

0.0.10

• docs: Updated preview GIF paths to absolute raw GitHub URLs for proper pub.dev rendering.
• docs: Added link to introducing journal article.

0.0.9

• docs: Added preview animations (nav.GIF and screen_record.GIF) in README.md.
• docs: Removed all emojis from README.md to maintain clean and readable formatting.

0.0.8

• fix: Cleaned up package metadata and license notation.

0.0.7

• docs: Added comprehensive API reference documentation for all public and internal methods across all services.
• docs: Added full function reference tables for NavigationVoiceService, DynamicMapCubit, MarkerMotionService, LocationTrackingService, MapCameraService, RouteCalculationService, and IconService.
• docs: Documented internal lifecycle methods (_initializeTts, _updateDisplayInstructions, _checkNavigationProgress, _snapToClosestStep, _checkOffRoute, _buildGradientPolylines, etc.) for contributors.
• docs: Added internal vs public method distinction tables with visibility, return type, and description columns.

0.0.6

• fix: Roundabout exit number now correctly read from OSRM maneuver.exit field, eliminating wrong-exit voice announcements.
• fix: OSRM instructions no longer say "onto" when the street has no name (e.g. small roads/alleys). Now gracefully omits the street suffix.
• fix: recalculateRoute now uses raw GPS position (_lastRealGpsPosition) instead of the interpolated marker position, fixing rerouting failure on small roads/alleys.
• fix: iOS Live Activity updateActivity now iterates all active activities instead of relying on a cached in-memory ID, fixing silent update failures in Release builds.
• fix: iOS Live Activity update now uses the modern ActivityContent API instead of the deprecated activity.update(using:).
• perf: Camera updates throttled to 500ms (simulator) / 1500ms (real GPS) to prevent Android stutter at high speeds.
• perf: Speed display uses an 8-sample moving average with a 1 km/h emission threshold to prevent digit flickering.

0.0.5

• feat: Simulator mode now resets and reroutes when stopped, returning to the real GPS position.
• feat: Engine badge (OSRM / Google Maps) is only visible when simulator is active.
• fix: routeDuration and routeDistance now correctly passed through state to OrderDetailsSheet.
• fix: Empty order item summary now shows a friendly message instead of "-".

0.0.4

• feat: Add smooth marker animation using MarkerMotionService with interpolation.
• feat: Add voice turn-by-turn navigation with NavigationVoiceService.
• feat: Smart road snapping — driver icon stays clamped to the route polyline.
• feat: Auto rerouting with configurable offRouteDistance and offRouteThreshold.

0.0.3

• feat: add cost optimization comparison to README.
• fix: integrate custom color support for icons.

0.0.2

• feat: update navigation and voice engine.

0.0.1

• Initial release.