Simple cross platform plugin to handle geofence events such as entering, leaving and staying in a geofence region.
Supports
Call CrossGeofence.Current from any project or PCL to gain access to APIs. Must initialize plugin on each platform before use. Should only be used after initialization, if not will get GeofenceNotInitializedException.
CrossGeofence.Initialize<'T'> This methods initializes geofence plugin. The generic T should be a class that implements IGeofenceListener. This will be the class were you would listen to all geofence events.
On the AppDelegate:
public override bool FinishedLaunching (UIApplication app, NSDictionary options)
{
//Initialization...
CrossGeofence.Initialize<CrossGeofenceListener> ();
return base.FinishedLaunching (app, options);
}
Create an Geofence service class to be able to handle geofence events even when application is closed.
[Service]
public class GeofenceService : Service
{
public override void OnCreate()
{
base.OnCreate();
System.Diagnostics.Debug.WriteLine("Geofence Service - Created");
}
public override StartCommandResult OnStartCommand(Android.Content.Intent intent, StartCommandFlags flags, int startId)
{
System.Diagnostics.Debug.WriteLine("Geofence Service - Started");
return StartCommandResult.Sticky;
}
public override Android.OS.IBinder OnBind(Android.Content.Intent intent)
{
System.Diagnostics.Debug.WriteLine("Geofence Service - Binded");
return null;
}
public override void OnDestroy()
{
System.Diagnostics.Debug.WriteLine("Geofence Service - Destroyed");
base.OnDestroy();
}
}
Initialization on Application class.
[Application]
public class GeofenceAppStarter : Application
{
public static Context AppContext;
public GeofenceAppStarter(IntPtr javaReference, JniHandleOwnership transfer) : base(javaReference, transfer)
{
}
public override void OnCreate()
{
base.OnCreate();
AppContext = this.ApplicationContext;
//TODO: Initialize CrossGeofence Plugin
//TODO: Specify the listener class implementing IGeofenceListener interface in the Initialize generic
//CrossGeofence.Initialize<CrossGeofenceListener>();
//CrossGeofence.GeofenceListener.OnAppStarted();
//Start a sticky service to keep receiving geofence events when app is closed.
StartService();
}
public static void StartService()
{
AppContext.StartService(new Intent(AppContext, typeof(GeofenceService)));
if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.Kitkat)
{
PendingIntent pintent = PendingIntent.GetService(AppContext, 0, new Intent(AppContext, typeof(GeofenceService)), 0);
AlarmManager alarm = (AlarmManager)AppContext.GetSystemService(Context.AlarmService);
alarm.Cancel(pintent);
}
}
public static void StopService()
{
AppContext.StopService(new Intent(AppContext, typeof(GeofenceService)));
if (Android.OS.Build.VERSION.SdkInt >= Android.OS.BuildVersionCodes.Kitkat)
{
PendingIntent pintent = PendingIntent.GetService(AppContext, 0, new Intent(AppContext, typeof(GeofenceService)), 0);
AlarmManager alarm = (AlarmManager)AppContext.GetSystemService(Context.AlarmService);
alarm.Cancel(pintent);
}
}
}
IGeofenceListener implementation
Must implement IGeofenceListener. This would be commonly implemented in the Core project if sharing code between Android or iOS. In the case you are using the plugin only for a specific platform this would be implemented in that platform.
public class CrossGeofenceListener : IGeofenceListener
{
public void OnMonitoringStarted(string region)
{
Debug.WriteLine(string.Format("{0} - Monitoring started in region: {1}", CrossGeofence.Tag, region));
}
public void OnMonitoringStopped()
{
Debug.WriteLine(string.Format("{0} - {1}", CrossGeofence.Tag, "Monitoring stopped for all regions"));
}
public void OnMonitoringStopped(string identifier)
{
Debug.WriteLine(string.Format("{0} - {1}: {2}", CrossGeofence.Tag, "Monitoring stopped in region", identifier));
}
public void OnError(string error)
{
Debug.WriteLine(string.Format("{0} - {1}: {2}", CrossGeofence.Tag, "Error", error));
}
// Note that you must call CrossGeofence.GeofenceListener.OnAppStarted() from your app when you want this method to run.
public void OnAppStarted()
{
Debug.WriteLine(string.Format("{0} - {1}", CrossGeofence.Tag, "App started"));
}
public void OnRegionStateChanged(GeofenceResult result)
{
Debug.WriteLine(string.Format("{0} - {1}", CrossGeofence.Tag, result.ToString()));
}
}
Enum of Geofence Transaction Types:
/// <summary>
/// GeofenceTransition enum
/// </summary>
public enum GeofenceTransition
{
/// <summary>
/// Entry transition
/// </summary>
Entered,
/// <summary>
/// Exit transition
/// </summary>
Exited,
/// <summary>
/// Stayed in transition
/// </summary>
Stayed,
/// <summary>
/// Unknown transition
/// </summary>
Unknown
}
Class to define and configure geofence region
/// <summary>
/// Region identifier
/// </summary>
public string Id { get; set; }
/// <summary>
/// Region center Latitude
/// </summary>
public double Latitude { get; set; }
/// <summary>
/// Region center Longitude
/// </summary>
public double Longitude { get; set; }
/// <summary>
/// Radius covered by the region in meters
/// </summary>
public double Radius { get; set; }
/// <summary>
/// Notify when enters region
/// </summary>
public bool NotifyOnEntry { get; set; }
/// <summary>
/// Notify when stays in region based on the time span specified in StayedInThresholdDuration
/// Note: Stayed in transition will not be fired if device has exit region before the StayedInThresholdDuration
/// </summary>
public bool NotifyOnStay { get; set; }
/// <summary>
/// Notify when exits region
/// </summary>
public bool NotifyOnExit { get; set; }
/// <summary>
/// Notitication message when enters region
/// </summary>
public string NotificationEntryMessage { get; set; }
/// <summary>
/// Notification message when exits region
/// </summary>
public string NotificationExitMessage { get; set; }
/// <summary>
/// Notification message when stays in region
/// </summary>
public string NotificationStayMessage { get; set; }
/// <summary>
/// Persist region so that is available after application closes
/// </summary>
public bool Persistent { get; set; }
/// <summary>
/// Enables showing local notifications. Defaults to showing all notifications, unless setting ShowEntry/Exit/StayNotification entries to false.
/// Messages could be configured using properties: NotificationEntryMessage, NotificationExitMessage, NotificationStayMessage
/// </summary>
public bool ShowNotification { get; set; }
/// <summary>
/// Enables showing local entry notifications. ShowNotification must be true.
/// Messages could be configured using properties: NotificationEntryMessage
/// </summary>
public bool ShowEntryNotification { get; set; }
/// <summary>
/// Enables showing local exit notifications. ShowNotification must be true.
/// Messages could be configured using properties: NotificationExitMessage
/// </summary>
public bool ShowExitNotification { get; set; }
/// <summary>
/// Enables showing local stay notifications. ShowNotification must be true.
/// Messages could be configured using properties: NotificationStayMessage
/// </summary>
public bool ShowStayNotification { get; set; }
/// <summary>
/// Sets minimum duration time span before passing to stayed in transition after an entry
/// </summary>
public TimeSpan StayedInThresholdDuration;
When there is a geofence event update you will get an instance of this class.
/// <summary>
/// Last time entered the geofence region
/// </summary>
public DateTime? LastEnterTime { get; set; }
/// <summary>
/// Last time exited the geofence region
/// </summary>
public DateTime? LastExitTime { get; set; }
/// <summary>
/// Result transition type
/// </summary>
public GeofenceTransition Transition { get; set; }
/// <summary>
/// Region identifier
/// </summary>
public string RegionId { get; set; }
/// <summary>
/// Duration span between last exited and entred time
/// </summary>
public TimeSpan? Duration { get { return LastExitTime - LastEnterTime; } }
/// <summary>
/// Time span between the last entry and current time.
/// </summary>
public TimeSpan? SinceLastEntry { get { return DateTime.Now - LastEnterTime; } }
/// <summary>
/// Result latitude
/// </summary>
public double Latitude { get; set; }
/// <summary>
/// Result longitude
/// </summary>
public double Longitude { get; set; }
/// <summary>
/// Result accuracy
/// </summary>
public double Accuracy { get; set; }
Methods and properties
StartMonitoring
Start monitoring in specified region
void StartMonitoring(GeofenceCircularRegion region);
Starts monitoring multiple regions
void StartMonitoring(IList<GeofenceCircularRegion> regions);
StopMonitoring
Stop monitoring specified geofence region.
void StopMonitoring(GeofenceCircularRegion region);
Stop monitoring multiple regions.
void StopMonitoring(IList<GeofenceCircularRegion> regions);
StopMonitoringAllRegions
Stop monitoring all geofence regions.
void StopMonitoringAllRegions();
IsLocationEnabled
Determines whether location is enabled and returns the result to the specified action.
void IsLocationEnabled(Action<bool> returnAction);
LastKnownLocation
Last known geofence location. This location will be null if isn't monitoring any regions yet.
GeofenceLocation LastKnownLocation { get; }
IsMonitoring
Indicator that is true if at least one region is been monitored
bool IsMonitoring { get; }
Regions
Dictionary that contains all regions been monitored
IReadOnlyDictionary<string, GeofenceCircularRegion> Regions { get; }
GeofenceResults
Dicitonary that contains all geofence results received
IReadOnlyDictionary<string, GeofenceResult> GeofenceResults { get; }
Start monitoring a region
CrossGeofence.Current.StartMonitoring(new GeofenceCircularRegion ("My Region",18.4802878,-69.9469203,52220) {
//To get notified if user stays in region for at least 5 minutes
NotifyOnStay=true,
StayedInThresholdDuration=TimeSpan.FromMinutes(5)
});
This are special features you can enable or change values. By default plugin uses Balanced Power Priority.
//Set the Priority for the Geofence Tracking Location Accuracy
public static GeofencePriority GeofencePriority { get; set; }
//Set the smallest displacement should be done from current location before a location update
public static float SmallestDisplacement { get; set; }
/// Request the user for Notifications Permission. Set to false if this is already handled in the client application.
public static bool RequestNotificationPermission { get; set; }
/// Request the user for Location Services Permissions. Set to false if this is already handled in the client application.
public static bool RequestLocationPermission { get; set; }
Geofence Accuracy Precision Priority enum
/// <summary>
/// Geofence Accuracy Precision Priority enum
/// </summary>
public enum GeofencePriority
{
/// <summary>
/// Sets the location updates for balanced power accurancy basing location on Cells and WiFi spots.
/// </summary>
BalancedPower,
/// <summary>
/// Highest accuracy uses GPS and other sources to determine best location precision
/// </summary>
HighAccuracy,
/// <summary>
/// Acceptable accuracy
/// </summary>
AcceptableAccuracy,
/// <summary>
/// Medium accuracy - Low Battery Usage
/// </summary>
MediumAccuracy,
/// <summary>
/// Low accuracy - Low Battery Usage
/// </summary>
LowAccuracy,
/// <summary>
/// Lowest Acurracy - No Power
/// </summary>
LowestAccuracy
}
Requires the following permissions:
There are a few things you can configure in Android project using the following properties from CrossGeofence class:
//The sets the resource id for the icon will be used for the notification
public static int IconResource { get; set; }
//The sets the sound uri will be used for the notification
public static Android.Net.Uri SoundUri { get; set; }
/// ARGB Color used for notification
public static int Color { get; set; }
/// Large icon resource used for notification
public static Android.Graphics.Bitmap LargeIconResource { get; set; }
//Sets update interval for the location updates
public static int LocationUpdatesInterval { get; set; }
//Sets fastest interval for the location updates
public static int FastestLocationUpdatesInterval { get; set; }
Installation error: INSTALL_PARSE_FAILED_MANIFEST_MALFORMED
You need to do is to add the following key to your Info.plist file:
NSLocationAlwaysUsageDescription
You can enter a string like “Location is required to find out where you are” which, as in iOS 7, can be localized in the Info.plist file.
This wouldn't be possible without all these great developer posts, articles and references:
Thanks!
Licensed under main repo license