배치 모니터 API 참조

위치 모니터 확장 등록

위치 모니터 확장을 코어 이벤트 허브에 등록합니다.

RegisterExtension (Android)

다음은 이 API의 구문 및 예제 코드입니다.

구문

다음은 Java의 구문입니다.

public static void registerExtension();

예

나머지 Experience Platform SDK를 초기화하는 onCreate 메서드에서 이 메서드를 호출합니다.

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

익스텐션 버전

위치 모니터 확장 프로그램의 현재 버전을 반환합니다.

익스텐션 버전(Android)

다음은 이 API의 구문 및 예제 코드입니다.

구문

public static String extensionVersion();

예

String placesMonitorVersion = PlacesMonitor.extensionVersion();

ExtensionVersion(iOS)

다음은 이 API의 구문 및 예제 코드입니다.

구문

+ (nonnull NSString*) extensionVersion;

예

NSString *placesMonitorVersion = [ACPPlacesMonitor extensionVersion];

디바이스 모니터링 시작

장치의 위치를 추적하고 주변 위치 모니터링을 시작합니다.

시작(Android)

사용자가 장치 위치 사용 권한을 부여하지 않은 경우, API에 대한 첫 번째 호출은 사용자에게 권한을 start 요청합니다.

다음은 이 API의 구문 및 예제 코드입니다.

구문

public static void start();

예

PlacesMonitor.start();

시작(iOS)

제공된 콜백에서 SDK start 가 초기화를 완료했는지 확인할 수 ACPCore::start:있습니다.

다음은 이 API의 구문 및 예제 코드입니다.

구문

+ (void) start;

예

SDK를 초기화할 때 위치 모니터 시작:

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

앱 실행 중 나중에 위치 모니터 시작:

[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를 사용하여 사용자에게 장소 서비스에 대해 사용할 수 있도록 요청되고 권한이 부여된 위치 권한 유형을 설정할 수 있습니다.

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

  앱이 사용 중인 동안 사용자에게 장소 서비스를 사용할 수 있는 권한을 요청합니다. 사용자 프롬프트에는 앱 Info.plist 파일의 NSLocationWhenInUseUsageDescription 키 텍스트가 포함되며 이 메서드를 호출할 때는 해당 키가 있어야 합니다. 자세한 내용은 requestWhenInUseAuthorization에 대한 Apple 설명서를 참조하십시오.

• ACPPlacesRequestMonitorAuthorizationLevelAlways

  앱이 백그라운드에 있는 경우에도 이 열거형을 사용하여 Places Service를 요청합니다. 앱의 Info.plist에 NSLocationAlwaysUsageDescription 및 NSLocationWhenInUseUsageDescription 키가 있어야 합니다. 이러한 키는 사용자 프롬프트 중에 표시되는 텍스트를 정의합니다. 자세한 내용은 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];