AlarmService class Routes & Navigation

Provides monitoring and notification for navigation-related alarm events.

The AlarmService manages a variety of alarm types including speed limit violations, landmark proximity alerts, overlay item notifications (such as safety cameras and social reports), geographic boundary crossings, tunnel entry/exit events, and day/night mode transitions. Configure the service with an AlarmListener to receive callbacks for these events.

Multiple AlarmService and AlarmListener instances can operate simultaneously, enabling concurrent monitoring of different events or areas.

Make sure to keep a reference to both the AlarmService and AlarmListener instances for as long as you want to receive alarm notifications. If either instance is garbage collected, alarm callbacks will stop being triggered.

Example

AlarmService? alarmService;

// Create an alarm listener with callbacks
AlarmListener alarmListener = AlarmListener(
  onHighSpeed: (limit, insideCityArea) {
    print('Speed limit exceeded: $limit m/s');
  },
  onLandmarkAlarmsUpdated: () {
    LandmarkAlarmsList landmarkAlarms = alarmService!.landmarkAlarms;
    print('Approaching ${landmarkAlarms.items.first.landmark.name}');
  },
);

// Create the alarm service
alarmService = AlarmService(alarmListener);

// Trigger alarms within 200m and monitor even without active navigation
alarmService.alarmDistance = 200;
alarmService.monitorWithoutRoute = true;

See also:

• AlarmListener - For configuring alarm event callbacks.
• OverlayItemAlarmsList - For managing overlay item alarm lists.
• LandmarkAlarmsList - For managing landmark alarm lists.