Uso de la extensión Monitor de lugares

Para utilizar la extensión Monitor de lugares, complete las siguientes tareas:

Instalar la extensión del monitor de lugares en el Experience Platform Launch

1. In Experience Platform Launch, click the Extensions tab.
2. En la Catalog ficha, ubique la Places Monitor extensión y haga clic en Instalar.
3. Haga clic en Save.
4. Siga el proceso de publicación para actualizar la configuración del SDK.

Configurar la extensión del monitor de lugares

No hay tareas de configuración para la extensión Places Monitor.

de lugares

Añadir la extensión del monitor de lugares a la aplicación

A continuación se indican las instrucciones para agregar la extensión Places Monitor a la aplicación Android o iOS.

La compatibilidad adicional de la plataforma para la extensión Monitor de lugares incluye:
Monitor de lugares de Cordova

Reaccionar monitor de lugares nativos

Monitor de lugares de flutter

Android

En Android, complete los siguientes pasos:

Java

1. Añada la extensión Places Monitor y la extensión Places al proyecto mediante el archivo de gradle de la aplicación.

2. También incluya los servicios de ubicación de Google más recientes en el archivo de gradle.

   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. Importe la extensión Places Monitor en la actividad principal de la aplicación.

   import com.adobe.marketing.mobile.PlacesMonitor;
   

iOS

En iOS, complete los siguientes pasos:

1. Agregue la biblioteca a su proyecto a través de sus Cocoapods Podfile agregando el pod 'ACPPlacesMonitor'.
2. Importar las bibliotecas del Monitor de lugares y lugares:

Objective-C

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

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Registro y inicio del monitor de lugares

Debe registrar y inicio el Monitor de lugares en Android o iOS.

Android

En Android, complete los siguientes pasos:

Java

En el OnCreate método de la aplicación, registre las extensiones del monitor de lugares:

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

En las aplicacionesapplication:didFinishLaunchingWithOptionsde iOS, regístrese PlacesMonitor y coloque con Mobile Core:

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
}

Añadir permisos al manifiesto

Android

Java

Para todas las versiones de Android, para declarar que la aplicación necesita permisos de ubicación, agregue un <uses-permission> elemento en el manifiesto de la aplicación, como elemento secundario del <manifest> elemento de nivel superior. Para las aplicaciones de Android que destinatario API Nivel 29 y superior, para permitir que la aplicación tenga acceso a la ubicación en segundo plano, incluya el permiso 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>

Habilitar las actualizaciones de ubicación en segundo plano

iOS admite el envío de eventos de ubicación en aplicaciones que están suspendidas o que ya no se están ejecutando. Para recibir actualizaciones de ubicación en segundo plano para la extensión Monitor de lugares, configure la capacidad de actualizaciones de ubicación para la aplicación en Xcode.background-location-updates.

Configuración de las claves plist

Se deben incluir las siguientes claves en el Info.plist archivo de la aplicación:

• NSLocationWhenInUseUsageDescription - el texto debe describir por qué la aplicación solicita acceso a la información de ubicación del usuario mientras se ejecuta en primer plano.
• NSLocationAlwaysAndWhenInUseUsageDescription - el texto debe describir por qué la aplicación solicita acceso a la información de ubicación del usuario en todo momento.