Riferimento API di Monitoraggio luoghi

Registra estensione monitor luoghi

Registra l’estensione Places Monitor con l’hub eventi di base.

RegisterExtension (Android)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

Di seguito è riportata la sintassi in Java:

public static void registerExtension();

Esempio

Chiama questo metodo nel onCreate metodo in cui inizializza il resto dell’SDK del Experience Platform .

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)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

Di seguito è riportata la sintassi in Objective-C:

+ (void) registerExtension;

Esempio

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

Versione estensione

Restituisce la versione corrente dell'estensione Places Monitor

ExtensionVersion (Android)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

public static String extensionVersion();

Esempio

String placesMonitorVersion = PlacesMonitor.extensionVersion();

ExtensionVersion (iOS)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

+ (nonnull NSString*) extensionVersion;

Esempio

NSString *placesMonitorVersion = [ACPPlacesMonitor extensionVersion];

Avvia monitoraggio dispositivo

Iniziare a monitorare la posizione del dispositivo e i luoghi vicini.

Start (Android)

Se l'autorizzazione per utilizzare la posizione del dispositivo non è stata concessa dall'utente, la prima chiamata all' start API richiede all'utente l'autorizzazione.

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

public static void start();

Esempio

PlacesMonitor.start();

Start (iOS)

Puoi verificare che l’SDK abbia terminato l’inizializzazione chiamando start dal callback fornito a ACPCore::start:.

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

+ (void) start;

Esempio

Avvio di Monitoraggio luoghi durante l'inizializzazione dell'SDK:

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

Avvio di Monitoraggio luoghi più tardi nell'esecuzione dell'app:

[ACPPlacesMonitor start];

Arresta il monitoraggio del dispositivo

Interrompe il tracciamento della posizione del dispositivo.

Interrompi (Android)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

public static void stop();

Esempio

PlacesMonitor.stop();

Interrompi (iOS)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

+ (void) stop;

Esempio

[ACPPlacesMonitor stop];

Aggiorna posizione

Utilizzate questa API per un aggiornamento immediato sulla posizione del dispositivo. Quando si chiama questa API, il dispositivo tenta di determinare la posizione con il livello di precisione specificato. Questo processo aggiorna anche i POI vicini monitorati dall’estensione.

UpdateLocation (Android)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

public static void updateLocation();

Esempio

PlacesMonitor.updateLocation();

UpdateLocationNow (iOS)

Sintassi

+ (void) updateLocationNow;

Esempio

[ACPPlacesMonitor updateLocationNow];

Autorizzazione Posizione app

Potete utilizzare questa API per impostare il tipo di autorizzazione di posizione che l'utente riceve e che l'utente è autorizzato a utilizzare per il servizio Places.

SetLocationPermission (Android)

Questa API imposta il tipo di richiesta di autorizzazione di posizione per il quale l'utente deve essere selezionato.

L’autorizzazione posizione può essere impostata su uno dei seguenti valori:

• PlacesMonitorLocationPermission.WHILE_USING_APP

  Questo valore richiede all'utente di accedere alla posizione del dispositivo solo quando utilizza l'applicazione. Un'app è considerata in uso quando l'utente sta visualizzando l'app sullo schermo del proprio dispositivo, ad esempio un'attività è in esecuzione in primo piano.

  SUGGERIMENTO

  Accertatevi che l'autorizzazione utente ACCESS_FINE_LOCATION sia impostata nel file manifesto dell'app.

• PlacesMonitorLocationPermission.ALWAYS_ALLOW

  Questo valore richiede all'utente di accedere alla posizione del dispositivo anche quando l'applicazione viene messa in background.

  SUGGERIMENTO

  Assicurati che le autorizzazioni utente ACCESS_BACKGROUND_LOCATION e ACCESS_FINE_LOCATION siano impostate nel file manifesto dell'app.

  PlacesMonitorLocationPermission.ALWAYS_ALLOW è il valore di autorizzazione di posizione predefinito.

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

public static void setLocationPermission(final PlacesMonitorLocationPermission placesMonitorLocationPermission)

Esempio

Per richiedere l' WHILE_USING_APP autorizzazione:

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

Per effettuare l'aggiornamento all' ALWAYS_ALLOW autorizzazione:

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

SetRequestAuthorizationLevel (iOS)

Questa API imposta il tipo di richiesta di autorizzazione di posizione per il quale verrà richiesto all'utente.

Per impostare il prompt di autorizzazione appropriato da visualizzare all'utente, chiamate SetRequestAuthorizationLevel prima di chiamare [ACPPlacesMonitor start]. Per impostare il prompt di autorizzazione appropriato da mostrare all'utente, chiamate questa API prima del [ACPPlacesMonitor start]. Se si richiama questo metodo durante il monitoraggio attivo, il livello di autorizzazione della posizione verrà aggiornato al valore di autorizzazione richiesto. Se il livello di autorizzazione richiesto è già fornito o rifiutato dall'utente dell'applicazione o in presenza di un downgrade dell'autorizzazione da ACPPlacesRequestAuthorizationLevelAlways a ACPPlacesRequestAuthorizationLevelWhenInUse un'autorizzazione, questo metodo non ha alcun effetto.

Il livello di autorizzazione può essere impostato su uno dei seguenti valori:

• ACPPlacesRequestAuthorizationLevelWhenInUse

  Richiede all'utente l'autorizzazione per utilizzare il servizio Places mentre l'app è in uso. Il prompt dell'utente contiene il testo della NSLocationWhenInUseUsageDescription chiave nel file info.plist dell'app, e la presenza di tale chiave è necessaria quando si chiama questo metodo. Per ulteriori informazioni, consulta la documentazione Apple su requestWhenInUseAuthorization.

• ACPPlacesRequestMonitorAuthorizationLevelAlways

  Utilizzate questo enum per richiedere il servizio Luoghi anche quando l'app è in background. Devi avere le chiavi NSLocationAlwaysUsageDescription e nella NSLocationWhenInUseUsageDescription lista Info.plist dell'app. Queste chiavi definiscono il testo che verrà visualizzato durante il prompt dell'utente. Per ulteriori informazioni, consulta la documentazione Apple su requestAlwaysAuthorization.

ACPPlacesRequestAuthorizationLevelAlways è il valore predefinito di autorizzazione della richiesta.

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

+ (void) setRequestAuthorizationLevel: (ACPPlacesRequestAuthorizationLevel) requestAuthorizationLevel;

Esempio

Per richiedere l' ACPPlacesRequestAuthorizationLevelWhenInUse autorizzazione:

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

Per eseguire l'aggiornamento all' ACPPlacesRequestAuthorizationLevelAlways autorizzazione:

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

Modalità di monitoraggio (solo iOS)

Il monitoraggio può essere impostato su uno dei seguenti valori:

• ACPPlacesMonitorModeContinuous

  L'estensione di monitoraggio riceve ed elabora le posizioni più frequentemente. Questa strategia di monitoraggio consuma molta energia ma fornisce una maggiore precisione. Per ulteriori informazioni, consulta la documentazione Apple sul monitoraggiocontinuo.

• ACPPlacesMonitorModeSignificantChanges

  L'estensione di monitoraggio riceve ed elabora gli aggiornamenti della posizione solo dopo che il dispositivo si è spostato a una distanza significativa dalla posizione precedentemente elaborata. Questa strategia di monitoraggio consuma meno energia rispetto alla strategia di monitoraggio continuo. Per ulteriori informazioni, consulta la documentazione Apple sul monitoraggio significativo

SetPlacesMonitorMode (iOS)

Di seguito sono riportati la sintassi e il codice di esempio per questa API:

Sintassi

+ (void) setPlacesMonitorMode: (ACPPlacesMonitorMode) monitorMode;

Esempio

[ACPPlacesMonitor setPlacesMonitorMode:ACPPlacesMonitorModeSignificantChanges];