A Plugin for all your geofence interactions.
We have a minimum requirement of iOS 9.0.
In your Info.plist you'll need to add following keys:
- NSLocationWhenInUseUsageDescription
- NSLocationAlwaysAndWhenInUseUsageDescription
In your AndroidManifest.xml you should add the following lines:
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
You'll need to register for a background service as well.
<receiver android:name="com.intivoto.geofence.GeofenceBroadcastReceiver"
android:enabled="true" android:exported="true"/>
<service android:name="com.intivoto.geofence.GeofencePlugin"
android:permission="android.permission.BIND_JOB_SERVICE" android:exported="true"/>
This should be sufficient if your app runs with the new Android embedding (v2, Flutter 1.12), also see: https://flutter.dev/docs/development/packages-and-plugins/plugin-api-migration.
There is a small example app that prints to console to give an example of functionality of this plugin. At the current time following commands are supported.
Currently you need to initialize the plugin to let it setup it's system. This might be altered in later versions.
Geofence.initialize();
This will give you a Future which will resolve with the current Coordinate of the user. If there is one that's recent enough (< 60 seconds old), it'll return this location.
Example usage:
Geofence.getCurrentLocation().then((coordinate) {
print("Your latitude is ${coordinate.latitude} and longitude ${coordinate.longitude}");
});
This gives you the possibility to add regions to the native geofence manager. Note that even though by adding them they will get triggered, nothing will happen in your app just yet. You also need to start listening to them. You'll get a callback to tell you that your region has been scheduled though.
Geofence.addGeolocation(location, GeolocationEvent.entry).then((onValue) {
scheduleNotification("Georegion added", "Your geofence has been added!");
}).catchError((error) {
print("failed with $error");
});
Start listening to geoevents as they happen.
Geofence.startListening(GeolocationEvent.entry, (entry) {
scheduleNotification("Entry of a georegion", "Welcome to: ${entry.id}");
});