https://github.com/aritchie/geofences

Cross platform geofencing library that works on iOS, Android, and Windows
https://github.com/aritchie/geofences

Last synced: 30 days ago
JSON representation

Cross platform geofencing library that works on iOS, Android, and Windows

• Host: GitHub
• URL: https://github.com/aritchie/geofences
• Owner: aritchie
• License: mit
• Archived: true
• Created: 2015-07-22T12:31:24.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2021-08-04T21:19:26.000Z (over 3 years ago)
• Last Synced: 2024-05-29T08:35:57.481Z (7 months ago)
• Language: C#
• Homepage:
• Size: 5.37 MB
• Stars: 61
• Watchers: 9
• Forks: 18
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-xamarin-forms - Geofence ★59

README

        
# UPDATE - This library has now moved to the Shiny Framework at https://github.com/shinyorg/shiny

## ACR Geofence Plugin for Xamarin & Windows

A cross platform library for Xamarin & Windows that allows for easy geofence detection

## PLATFORMS

|Platform|Version|

| ------------------- |:------------------: |

|Xamarin.iOS|iOS 6+|

|Xamarin.Android|API 10+|

|Windows 10 UWP|10+|

## SETUP

Be sure to install the Plugin.Geofencing nuget package in all of your main platform projects as well as your core/NETStandard project

[![NuGet](https://img.shields.io/nuget/v/Plugin.Geofencing.svg?maxAge=2592000)](https://www.nuget.org/packages/Plugin.Geofencing/)

**Android**

Add the following to your AndroidManifest.xml

```xml

```

**iOS**

Add the following to your Info.plist

```xml

NSLocationAlwaysUsageDescription

Your message

```

**UWP**

Add location to your app manifest capabilities section

```xml

    

```

## HOW TO USE

### To start monitoring

    CrossGeofences.Current.StartMonitoring(new GeofenceRegion( 

        "My House", // identifier - must be unique per registered geofence

        Center = new Position(LATITUDE, LONGITUDE), // center point    

        Distance.FromKilometers(1) // radius of fence

    ));

### Wire up to notifications

    CrossGeofences.Current.RegionStatusChanged += (sender, args) => 

    {

        args.State // entered or exited

        args.Region // Identifier & details

    };

### Stop monitoring a region

    

    CrossGeofences.Current.StopMonitoring(GeofenceRegion);

    or

    CrossGeofences.Current.StopAllMonitoring();

### FAQ

* Q) Why create another geofence plugin

  A) I felt like the integration or bloat in other geofence libraries (stay, notifications, etc). I also didn't like that Google Play Services were required in Android which required your device to be online when creating the geofences.  This did not work with my requirements

* Q) Why use a cross platform GPS library for Android?

  

  A) James has done a ton of work around the Android geolocation mess.  I didn't want to duplicate this.  I just wanted to attach to an event and set the desired accuracy

* Q) Yes, but what about google play services?

  A) The amount of code necessary to register a geofence as well as all of the junk that came with it made it annoying and no less of a drain on the battery