使用Places Monitor擴充功能

要使用Places Monitor擴展，請完成以下任務：

在Experience Platform Launch中安裝Places Monitor擴充功能

1. In Experience Platform Launch, click the Extensions tab.
2. 在標籤 Catalog 上，找到擴充 Places Monitor 功能，然後按一下 安裝。
3. 按一下「Save」。
4. 依照發佈程式更新SDK組態。

配置Places Monitor擴展

Places Monitor擴展沒有配置任務。

‌

將Places Monitor擴充功能新增至您的應用程式

以下說明如何將Places Monitor擴充功能新增至Android或iOS應用程式。

Places Monitor擴充功能的其他平台支援包括：Cordova Places Monitor

React Native Places Monitor

顫振位置監視器

Android

在Android中，完成下列步驟：

Java

1. 使用應用程式的Gradle檔案，將Places Monitor擴充功能和Places擴充功能新增至您的專案。

2. 此外，在Gradle檔案中也包含最新的Google位置服務。

   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. 在應用程式的主要活動中匯入Places Monitor擴充功能。

   import com.adobe.marketing.mobile.PlacesMonitor;
   

iOS

在iOS中，完成下列步驟：

1. Add the library to your project via your Cocoapods Podfile by adding pod 'ACPPlacesMonitor'.
2. 匯入「位置」和「位置」監控程式庫：

Objective-C

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

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

註冊並啟動Places Monitor

您必須註冊並啟動Android或iOS中的Places Monitor。

Android

在Android中，完成下列步驟：

Java

在您應用程式的方法中， OnCreate 註冊Places Monitor擴充功能：

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

在iOS應用程式中application:didFinishLaunchingWithOptions，註冊 PlacesMonitor 並放置行動核心：

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
}

新增權限至資訊清單

Android

Java

對於所有Android版本，若要宣告您的應用程式需要位置權限，請在應用程式資訊清單中新增元素，作為頂層元素的子項 <uses-permission> <manifest> 。 針對以API等級29及更高版本為目標的Android應用程式，若要允許應用程式存取背景中的位置，請加入ACCESS_BACKGROUND_LOCATION權限。

<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>

在背景啟用位置更新

iOS支援將位置事件傳送至已暫停或不再執行的應用程式。 若要在背景接收Places Monitor擴充功能的位置更新，請在中設定您應用程式的位置更新功能 Xcode.background-location-updates。

配置plist鍵

您的應用程式檔案中必須包含下列金 Info.plist 鑰：

• NSLocationWhenInUseUsageDescription -文字應說明應用程式在前景中執行時要求存取使用者位置資訊的原因。
• NSLocationAlwaysAndWhenInUseUsageDescription -文字應說明應用程式為何會隨時要求存取使用者的位置資訊。