iOS SDK 15.6.7,
Android SDK 15.5.3,
Hello Screen Dynamic States,
Bluedot Cordova plugin 4.0.1,
Bluedot Xamarin Android wrapper 15.5.2,
Bluedot Xamarin iOS wrapper 15.6.6,
Bluedot React Native wrapper 2.3.0,
Custom event metadata is a feature that is available in the Bluedot Point SDK for our customers to set additional event-specific metadata to our location events. For further information refer to Custom Event Metadata.
It is recommended to set the Custom Event Metadata before starting Geo-triggering or Tempo.
io.bluedot.cordova.plugin.setCustomEventMetaData({ orderId: "order_123", storeId: "store_456", customerId: "789" })
An app may optionally disable (and later re-enable) Zones by calling enableZone
and disableZone
. For further information refer to Enable or disable Zones documentation (Android | iOS)
const zoneId = "your_zone_id"; // Enable Zone io.bluedot.cordova.plugin.enableZone(zoneId); // Disable Zone io.bluedot.cordova.plugin.disableZone(zoneId);
Given the restrictions on accessing location data from the background, it is recommended that the Geo-triggering service be run as a foreground service, and the Tempo service must be run as a foreground service. For more information refer to Android – Location Permission & Notifications Best Practices.
To run Geotriggering or Tempo with Foreground Notification, please refer to the sample code below:
Geo-triggering
// GeoTriggering const androidNotificationParams = { channelId: "Bluedot Cordova", channelName: "Bluedot Cordova", title: "Bluedot Foreground Service - Geo-triggering", content: "This app is running a foreground service using location services", notificationId: 123, }; io.bluedot.cordova.plugin.androidStartGeoTriggering( function () { console.log ("Start Geotriggering Successful") }, function (error) { console.log ("Start Geotriggering Failed with error: " + error) }, androidNotificationParams.channelId, androidNotificationParams.channelName, androidNotificationParams.title, androidNotificationParams.content, androidNotificationParams.notificationId );
Tempo
// Tempo const tempoBuilder = new io.bluedot.cordova.plugin.TempoBuilder(); const androidNotificationParams = { channelId: 'Bluedot Cordova', channelName: 'Bluedot Cordova', title: 'Bluedot Foreground Service - Tempo', content: "This app is running a foreground service using location services" } io.bluedot.cordova.plugin.androidStartTempoTracking( function () { console.log("Start Tempo Successful") }, function (error) { console.log("Start Tempo Failed: " + error) }, "YOUR_DESTINATION_ID", androidNotificationParams.channelId, androidNotificationParams.channelName, androidNotificationParams.title, androidNotificationParams.content, androidNotificationParams.notificationId );
Bluedot Point SDK includes a method for apps to display app restart notification to a user after app termination. For further details refer to iOS Features – App restart.
To start Geo-Triggering with App Restart notification, please refer to sample code below:
io.bluedot.cordova.plugin.iOSStartGeoTriggeringWithAppRestartNotification( function () { console.log("Start Geotriggering Successful") }, function (error) { console.log("Start Geotriggering Failed with error: " + error) }, "Title", "Button Text" );
Note: This feature is not available in Tempo.