Utilisation de l'extension Places Monitor

Pour utiliser l'extension Places Monitor, effectuez les tâches suivantes :

Installez l’extension Places Monitor dans Experience Platform Launch

  1. Dans l’Experience Platform Launch, cliquez sur l’onglet Extensions.
  2. Dans l'onglet Catalogue, recherchez l'extension Moniteur des emplacements, puis cliquez sur Installer.
  3. Cliquez sur Enregistrer.
  4. Suivez le processus de publication pour mettre à jour la configuration du SDK.

Configuration de l'extension Places Monitor

Il n'existe aucune tâche de configuration pour l'extension du moniteur de lieux.

configuration du moniteur de lieux ‌

Ajouter l'extension Places Monitor à votre application

Vous trouverez ci-dessous les instructions concernant l’ajout de l’extension Places Monitor à votre application Android ou iOS.

La prise en charge des plates-formes supplémentaires pour l'extension Places Monitor inclut :
Cordova Places Monitor

Réagir à l'écran des emplacements natifs

Écran de battage

Android

Sous Android, procédez comme suit :

Java

  1. Ajoutez l’extension Places Monitor et l’extension Places à votre projet à l’aide du fichier de nivellement de votre application.

  2. Incluez également les derniers services Google Location dans le fichier de classement.

    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. Importez l’extension Places Monitor dans l’activité principale de votre application.

    import com.adobe.marketing.mobile.PlacesMonitor;
    

iOS

Sous iOS, procédez comme suit :

  1. Ajoutez la bibliothèque à votre projet via votre Podfile Cocoapods en ajoutant le pod 'ACPPlacesMonitor'.
  2. Importez les bibliothèques d’écran Lieux et Lieux :

Objective-C

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

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Enregistrer et début le moniteur des lieux

Vous devez enregistrer et début le moniteur de lieux sur Android ou iOS.

Android

Sous Android, procédez comme suit :

Java

Dans la méthode OnCreate de votre application, enregistrez les extensions du moniteur de lieux :

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

La surveillance des lieux dépend de l'extension Places. Lorsque vous installez manuellement l’extension Surveiller les Places, veillez à ajouter également la bibliothèque places.aar à votre projet.

iOS

Dans l’application iOS application:didFinishLaunchingWithOptions, inscrivez PlacesMonitor et les emplacements avec Mobile Core :

Objectif 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
}
IMPORTANT

La surveillance des lieux dépend de l'extension Places. Lors de l'installation manuelle de l'extension Places Monitor, veillez à ajouter également la bibliothèque libACPPlaces_iOS.a à votre projet.

Ajouter des autorisations pour le manifeste

Android

Java

Pour toutes les versions d'Android, pour déclarer que votre application a besoin d'une autorisation d'emplacement, ajoutez un élément <uses-permission> dans votre manifeste d'application, en tant qu'enfant de l'élément de niveau supérieur <manifest>. Pour les applications Android qui utilisent l'API de cible Niveau 29 et plus, pour permettre à l'application d'accéder à un emplacement en arrière-plan, incluez l'autorisation 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>

Activer les mises à jour d'emplacement en arrière-plan

iOS prend en charge la diffusion de événements d’emplacement pour les applications suspendues ou qui ne sont plus en cours d’exécution. Pour recevoir les mises à jour d'emplacement en arrière-plan pour l'extension Places Monitor, configurez la fonctionnalité de mises à jour d'emplacement pour votre application dans Xcode.background-location-updates.

utilisation du moniteur de lieux

Configuration des clés de liste

Les clés suivantes doivent être incluses dans le fichier Info.plist de votre application :

  • NSLocationWhenInUseUsageDescription - le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur lors de son exécution au premier plan.
  • NSLocationAlwaysAndWhenInUseUsageDescription - le texte doit décrire pourquoi l’application demande l’accès aux informations d’emplacement de l’utilisateur en tout temps.
CONSEIL

Si votre application prend en charge iOS 10 et les versions antérieures, la clé NSLocationAlwaysUsageDescription est également requise.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now