Places Monitor API参考

注册地点监视器扩展

向核心事件集线器注册位置监视器扩展。

RegisterExtension(Android)

以下是此API的语法和示例代码：

语法

以下是Java中的语法：

public static void registerExtension();

示例

在初始化Experience Platform onCreate SDK其余部分的方法中调用此方法。

public class MobileApp extends Application {
  @Override
  public void onCreate(){
     super.onCreate();
     MobileCore.setApplication(this);
     try {
        PlacesMonitor.registerExtension();
     } catch (Exception e) {
       //Log the exception
       }
    }
 }

RegisterExtension(iOS)

以下是此API的语法和示例代码：

语法

以下是Objective-C中的语法：

+ (void) registerExtension;

示例

This method should be called in the didFinishLaunchingWithOptions delegate method of the AppDelegate.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    [ACPCore configureWithAppId:@"launch-appID"];
    [ACPPlaces registerExtension];
    [ACPPlacesMonitor registerExtension];

    [ACPCore start:^{
        // do other initialization of the SDK
    }];

    return YES;
}

扩展版本

返回当前版本的Places Monitor扩展

扩展版本(Android)

以下是此API的语法和示例代码：

语法

public static String extensionVersion();

示例

String placesMonitorVersion = PlacesMonitor.extensionVersion();

扩展版本(iOS)

以下是此API的语法和示例代码：

语法

+ (nonnull NSString*) extensionVersion;

示例

NSString *placesMonitorVersion = [ACPPlacesMonitor extensionVersion];

开始设备监控

开始跟踪设备的位置并监控附近的地点。

开始(Android)

如果用户尚未授予使用设备位置的授权，则对API的第一次调用将 start 提示用户授予权限。

以下是此API的语法和示例代码：

语法

public static void start();

示例

PlacesMonitor.start();

开始(iOS)

您可以通过从提供给的回调中调用来 start 确保SDK已完成初始化 ACPCore::start:。

以下是此API的语法和示例代码：

语法

+ (void) start;

示例

在SDK初始化时启动位置监视器：

[ACPCore start:^{
    [ACPPlacesMonitor start];
}];

稍后在应用程序执行中启动Places Monitor:

[ACPPlacesMonitor start];

停止设备监视

停止跟踪设备的位置。

停止(Android)

以下是此API的语法和示例代码：

语法

public static void stop();

示例

PlacesMonitor.stop();

停止(iOS)

以下是此API的语法和示例代码：

语法

+ (void) stop;

示例

[ACPPlacesMonitor stop];

更新位置

使用此API可立即更新设备的位置。 当您调用此API时，设备将尝试按照您指定的准确程度确定位置。 此过程还会刷新扩展监视的附近POI。

UpdateLocation(Android)

以下是此API的语法和示例代码：

语法

public static void updateLocation();

示例

PlacesMonitor.updateLocation();

UpdateLocationNow(iOS)

语法

+ (void) updateLocationNow;

示例

[ACPPlacesMonitor updateLocationNow];

应用程序位置权限

您可以使用此API设置用户被提示并授权用于Places Service的位置权限类型。

SetLocationPermission(Android)

此API设置用户被提示选择的位置权限请求类型。

位置权限可以设置为以下值之一：

• PlacesMonitorLocationPermission.WHILE_USING_APP

  此值仅在使用应用程序时提示用户访问设备位置。 当用户在其设备屏幕上查看应用程序时，例如，活动正在前台运行时，会认为该应用程序正在使用。

  小贴士

  确保在应用程序的清单文件中设置了ACCESS_FINE_LOCATION用户权限。

• PlacesMonitorLocationPermission.ALWAYS_ALLOW

  此值提示用户访问设备位置，即使应用程序是后台应用程序也是如此。

  小贴士

  确保在应用程序的清单文件中设置了ACCESS_BACKGROUND_LOCATION和ACCESS_FINE_LOCATION用户权限。

  PlacesMonitorLocationPermission.ALWAYS_ALLOW 是默认位置权限值。

以下是此API的语法和示例代码：

语法

public static void setLocationPermission(final PlacesMonitorLocationPermission placesMonitorLocationPermission)

示例

要请求权限，请执 WHILE_USING_APP 行以下操作：

// set the location permission
PlacesMonitor.setLocationPermission(PlacesMonitorLocationPermission.WHILE_USING_APP);
// start monitoring
PlacesMonitor.start()

升级到权 ALWAYS_ALLOW 限：

// upgrade the permission level
PlacesMonitor.setLocationPermission(PlacesMonitorLocationPermission.ALWAYS_ALLOW);

SetRequestAuthorizationLevel(iOS)

此API设置将提示用户的位置授权请求的类型。

要设置向用户显示的适当授权提示，请在呼叫 SetRequestAuthorizationLevel 前拨叫 [ACPPlacesMonitor start]。 要设置向用户显示的适当授权提示，请在之前调用此API [ACPPlacesMonitor start]。 在主动监控时调用此方法会将位置授权级别升级到请求的授权值。 如果应用程序用户已提供或拒绝请求的授权级别，或者当权限从授权降级到授权 ACPPlacesRequestAuthorizationLevelAlways 时 ACPPlacesRequestAuthorizationLevelWhenInUse ，此方法不起作用。

授权级别可以设置为以下值之一：

• ACPPlacesRequestAuthorizationLevelWhenInUse

  在应用程序使用中请求用户使用Places Service的权限。 用户提示包含来自应用程 NSLocationWhenInUseUsageDescription 序Info.plist文件中键的文本，调用此方法时需要该键的存在。 有关详细信息，请参 阅有关requestWhenInUseAuthorization的Apple文档。

• ACPPlacesRequestMonitorAuthorizationLevelAlways

  使用此枚举来请求Places服务，即使应用程序处于后台也是如此。 您必须在应 NSLocationAlwaysUsageDescription 用程 NSLocationWhenInUseUsageDescription 序的Info.plist中包含和密钥。 这些键定义将在用户提示期间显示的文本。 有关详细信息，请参 阅有关requestAlwaysAuthorization的Apple文档。

ACPPlacesRequestAuthorizationLevelAlways 是默认的请求授权值。

以下是此API的语法和示例代码：

语法

+ (void) setRequestAuthorizationLevel: (ACPPlacesRequestAuthorizationLevel) requestAuthorizationLevel;

示例

要请求权限，请执 ACPPlacesRequestAuthorizationLevelWhenInUse 行以下操作：

// set the request authorization level
[ACPPlacesMonitor setRequestAuthorizationLevel: ACPPlacesRequestAuthorizationLevelWhenInUse];
// start monitoring
[ACPPlacesMonitor start];

升级到授 ACPPlacesRequestAuthorizationLevelAlways 权：

// set the request authorization level
[ACPPlacesMonitor setRequestAuthorizationLevel: ACPPlacesRequestAuthorizationLevelAlways];

监视模式（仅限iOS）

可以将监视设置为以下值之一：

• ACPPlacesMonitorModeContinuous

  监控扩展更频繁地接收和处理位置。 这种监控策略耗电大，但精度较高。 有关详细信息，请参 阅Apple持续监控文档。

• ACPPlacesMonitorModeSignificantChanges

  监控扩展仅在设备移动了与先前处理的位置相距的显着距离后接收和处理位置更新。 该监控策略比连续监控策略耗电少。 有关详细信息，请参 阅Apple重要监控文档

SetPlacesMonitorMode(iOS)

以下是此API的语法和示例代码：

语法

+ (void) setPlacesMonitorMode: (ACPPlacesMonitorMode) monitorMode;

示例

[ACPPlacesMonitor setPlacesMonitorMode:ACPPlacesMonitorModeSignificantChanges];