Skip to main content

Get started with Alarms

|

The alarm system within the C++ SDK offers a range of monitoring and notification functionalities. It allows for the detection and management of different types of alarms, such as boundary crossings, speed limit violations, and landmark alerts. The system provides the ability to configure parameters like alarm distance, overspeed thresholds, and whether monitoring should occur even without a route being followed.

The key feature of this system is its ability to monitor specific geographic areas or routes and trigger alarms when predefined conditions, such as crossing a boundary or entering/exiting a tunnel, are met. It also provides customization options for alarm behavior based on location (e.g., inside or outside city limits). Additionally, users can set up callbacks to receive notifications about specific events, including changes in monitoring state or when a landmark alarm is triggered.

The system supports interaction with various alarm types, including overlay item and landmark alarms, and offers an easy interface for both setting and getting alarm-related information.

tip

Multiple alarm services and listeners can operate simultaneously, allowing for the monitoring of various events concurrently.

Configure AlarmService and AlarmListener​

The code snippet provided below defines an AlarmListener and creates an AlarmService based on this listener:

// Create alarm listener and specify callbacks
class MyAlarmListenerImpl : public IAlarmListener
{
public:
    void onBoundaryCrossed() override {}
    void onMonitoringStateChanged(bool isMonitoringActive) override {}
    void onTunnelEntered() override {}
    void onTunnelLeft() override {}
    void onLandmarkAlarmsUpdated() override {}
    void onOverlayItemAlarmsUpdated() override {}
    void onLandmarkAlarmsPassedOver() override {}
    void onOverlayItemAlarmsPassedOver() override {}
    void onHighSpeed(double limit, bool insideCityArea) override {}
    void onSpeedLimit(double speed, double limit, bool insideCityArea) override {}
    void onNormalSpeed(double limit, bool insideCityArea) override {}
    void onEnterDayMode() override {}
    void onEnterNightMode() override {}
};

auto alarmListener = StrongPointerFactory<MyAlarmListenerImpl>();

// Create alarm service based on the previously created listener
StrongPointer<AlarmService> alarmService = AlarmService::produce(alarmListener);

Each callback method listed above can be specified to receive notifications about different events or topics, depending on your needs. These events cover a range of scenarios, such as boundary crossings, monitoring state changes, tunnel entries or exits, speed limits, and more. By customizing the callbacks, you can tailor the notifications to suit specific use cases, ensuring that the system responds appropriately to various triggers or conditions.

warning

The AlarmListener and AlarmService objects must remain in memory for the duration of the notification period. If these objects are removed, the callbacks will not be triggered. It's recommended to keep the AlarmListener and AlarmService variables in a class that is alive during the whole session.

Change the alarm listener​

The alarm listener associated with the alarm service can be updated at any time, allowing for dynamic configuration and flexibility in handling various notifications.

StrongPointer<AlarmService> alarmService = AlarmService::produce(alarmListener);

alarmService->setAlarmListener( alarmListener );
note

Only one listener can be assigned to a service. For instance, if a new listener is registered using setAlarmListener, only the most recently set listener will be invoked when the events occur.

Last updated on