Using the Places Monitor extension

To use the Places Monitor extension, complete the following tasks:

Install the Places Monitor extension in Experience Platform Launch

1. In Experience Platform Launch, click the Extensions tab.
2. On the Catalog tab, locate the Places Monitor extension, and click Install.
3. Click Save.
4. Follow the publishing process to update the SDK configuration.

Configure the Places Monitor extension

There are no configuration tasks for the Places Monitor extension.

‌

Add the Places Monitor extension to your app

Directions on adding the Places Monitor extension to your Android or iOS application is below.

Additional platform support for the Places Monitor extension include:
Cordova Places Monitor

React Native Places Monitor

Flutter Places Monitor

Android

In Android, complete the following steps:

Java

1. Add the Places Monitor extension and the Places extension to your project using your app’s gradle file.

2. Also include the latest Google Location services in the gradle file.

   implementation 'com.adobe.marketing.mobile:places:1.+'
   implementation 'com.adobe.marketing.mobile:places-monitor:1.+'
   implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
   implementation 'com.google.android.gms:play-services-location:16.0.0'
   

3. Import the Places Monitor extension in your application’s main activity.

   import com.adobe.marketing.mobile.PlacesMonitor;
   

iOS

In iOS, complete the following steps:

1. Add the library to your project via your Cocoapods Podfile by adding pod 'ACPPlacesMonitor'.
2. Import the Places and Places Monitor libraries:

Objective-C

#import "ACPCore.h"
#import "ACPPlaces.h"
#import "ACPPlacesMonitor.h"

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Register and start the Places Monitor

You need to register and start the Places Monitor in Android or iOS.

Android

In Android, complete the following steps:

Java

In your App’s OnCreate method register the Places Monitor extensions:

public class MobileApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        MobileCore.setApplication(this);
        MobileCore.ConfigureWithAppId("yourAppId");
        try {
            PlacesMonitor.registerExtension(); //Register PlacesMonitor with Mobile Core
            Places.registerExtension(); //Register Places with Mobile Core
            MobileCore.start(null);
            PlacesMonitor.start();//Start monitoring the geo-fences
        } catch (Exception e) {
            //Log the exception
        }
    }
}

iOS

In your iOS app’sapplication:didFinishLaunchingWithOptions, register PlacesMonitor and Places with Mobile Core:

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {
    [ACPCore configureWithAppId:@"yourAppId"];
    [ACPPlaces registerExtension];
    [ACPPlacesMonitor registerExtension];
    [ACPCore start:^{            
        // do other initialization required for the SDK
        [ACPPlacesMonitor start];
    }];

    return YES;
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    ACPCore.configure(withAppId: "yourAppId")
    ACPPlaces.registerExtension()       
    ACPPlacesMonitor.registerExtension()
    ACPCore.start({
        // do other initialization required for the SDK
        ACPPlacesMonitor.start()
    })

    // Override point for customization after application launch.        
    return true
}

Add permissions to the manifest

Android

Java

For all versions of Android, to declare that your app needs location permission, add a <uses-permission> element in your app manifest, as a child of the top-level <manifest> element. For Android applications that target API Level 29 and above, to allow the app to access location in background, include the ACCESS_BACKGROUND_LOCATION permission.

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.adobe.placesapp">
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    // Only for Android apps targeting API level 29 and above
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  <application>        
    ...    
  </application>
</manifest>

Enable location updates in the background

iOS supports the delivery of location events to apps that are suspended or no longer running. To receive location updates in the background for the Places Monitor extension, configure the Location updates capability for your app in Xcode.background-location-updates.

Configuring the plist keys

The following keys must be included in your app’s Info.plist file:

• NSLocationWhenInUseUsageDescription - the text should describe why the app is requesting access to the user’s location information while running in the foreground.
• NSLocationAlwaysAndWhenInUseUsageDescription - the text should describe why the app is requesting access to the user’s location information at all times.