Location Triggered

Install and configure the MoEngage Geofence SDK for location-triggered push in React Native.

Installation

To add MoEngage Geofence SDK to your application run the below command from a terminal

npm

npm install react-native-moengage-geofence

Note: This plugin is dependent on react-native-moengage plugin. Make sure you have installed the react-native-moengage plugin as well.

Android Installation

For location triggered push to work, ensure your Application has:

• Location permission
• Play Services Location Library
• Device’s location should be enabled

iOS Installation

Install the iOS dependencies for the react-native-moengage-geofence plugin with either CocoaPods or Swift Package Manager (SPM).

CocoaPods

1. Navigate to the ios directory.

2. Run the following command:

   Bash

   bundle exec pod install
   

Swift Package Manager (SPM)

SPM support is experimental and requires React Native 0.87 or later. For the supported packages, setup details, and limitations, refer to iOS Installation.

1. Navigate to the ios directory.

2. Set up SPM:

   • If the iOS project still uses CocoaPods, convert it once with npx react-native spm add --deintegrate. For more information, refer to Migrate From CocoaPods to SPM.

   • If the iOS project already uses SPM, run:

     Bash

     npx react-native spm
     

With SPM you no longer run pod install. The MoEngage native SDKs resolve automatically from their SPM repositories.

Configure Geofence

By default, the geofence feature is not enabled. To enable the feature call the below API.

TypeScript

import ReactMoEGeofence from 'react-native-moengage-geofence';
ReactMoEGeofence.startGeofenceMonitoring(YOUR_WORKSPACE_ID);

At any time if you want to stop the geofence monitoring or feature use the below API. This API will remove the existing geofences.

TypeScript

import ReactMoEGeofence from 'react-native-moengage-geofence';
ReactMoEGeofence.stopGeofenceMonitoring(YOUR_WORKSPACE_ID);