Show Menu
TÓPICOS×

Uso da extensão do Monitor de locais

Para usar a extensão do Places Monitor, conclua as seguintes tarefas:

Instale a extensão do Places Monitor no Experience Platform Launch

  1. In Experience Platform Launch, click the Extensions tab.
  2. Na Catalog guia, localize a Places Monitor extensão e clique em Instalar .
  3. Clique em Save .
  4. Siga o processo de publicação para atualizar a configuração do SDK.

Configurar a extensão do Monitor de locais

Não há tarefas de configuração para a extensão do Places Monitor.
de locais ‌

Adicionar a extensão do Monitor de locais ao seu aplicativo

As instruções sobre como adicionar a extensão do Places Monitor ao aplicativo Android ou iOS estão abaixo.
O suporte adicional à plataforma para a extensão do Places Monitor inclui: Monitor do Cordova Places

Android

No Android, execute as seguintes etapas:

Java

  1. Adicione a extensão do Places Monitor e a extensão Places ao seu projeto usando o arquivo gradle do aplicativo.
  2. Inclua também os serviços mais recentes do Google Location no arquivo 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 a extensão do Places Monitor na atividade principal do aplicativo.
    import com.adobe.marketing.mobile.PlacesMonitor;
    
    

iOS

No iOS, conclua as seguintes etapas:
  1. Adicione a biblioteca ao seu projeto por meio do Cocoapods Podfile , adicionando o pod 'ACPPlacesMonitor' .
  2. Importe as bibliotecas do Monitor de locais e locais:

Objetive-C

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

Swift

import ACPCore
import ACPPlaces
import ACPPlacesMonitor

Registrar e start o monitor de locais

Você precisa registrar e start o Places Monitor no Android ou iOS.

Android

No Android, execute as seguintes etapas:

Java

No OnCreate método do aplicativo, registre as extensões do Monitor de locais:
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
        }
    }
}

O monitoramento de locais depende da extensão de locais. Ao instalar manualmente a extensão do Places Monitor, adicione também a biblioteca places.aar ao projeto.

iOS

Em seus aplicativos application:didFinishLaunchingWithOptions iOS, registre-se PlacesMonitor e instale o Mobile Core:

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

O monitoramento de locais depende da extensão de locais. When manually installing the Places Monitor extension, ensure that you also add the libACPPlaces_iOS.a library to your project.

Adicionar permissões ao manifesto

Android

Java
Para todas as versões do Android, para declarar que seu aplicativo precisa de permissão de localização, adicione um <uses-permission> elemento no manifesto do aplicativo, como filho do elemento de nível superior <manifest> . Para aplicativos Android que públicos alvos API Nível 29 e superior, para permitir que o aplicativo acesse o local em segundo plano, inclua a permissão 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>

Ativar atualizações de localização em segundo plano

O iOS oferece suporte ao delivery de eventos de localização para aplicativos que estão suspensos ou que não estão mais em execução. Para receber atualizações de localização em segundo plano para a extensão do Places Monitor, configure o recurso de atualizações de localização para o aplicativo em Xcode.background-location-updates .

Configurar as teclas plist

As seguintes teclas devem ser incluídas no Info.plist arquivo do aplicativo:
  • NSLocationWhenInUseUsageDescription - o texto deve descrever o motivo pelo qual o aplicativo está solicitando acesso às informações de localização do usuário durante a execução em primeiro plano.
  • NSLocationAlwaysAndWhenInUseUsageDescription - o texto deve descrever por que o aplicativo está solicitando acesso às informações de localização do usuário a qualquer momento.
Se o aplicativo suportar iOS 10 e anteriores, a NSLocationAlwaysUsageDescription chave também será necessária.