Adobe Experience Platform Location Service
Adobe Experience Platform Location Service provides an SDK extension which allows you to act based on the location of your users. This extension is the interface to the Location Service Web Services APIs.
The SDK extension listens for events that contain GPS coordinates and geofence region events, and dispatches new events that are processed by the Rules Engine. The SDK extension also retrieves and delivers a list of the nearest POI for the app data that retrieves from the APIs. The regions returned by the APIs are stored in cache and persistence, which allows limited offline processing.
Places is the mobile SDK supporting the Location Service.

Configure the Places extension in Data Collection UI

  1. 1.
    In the Data Collection UI, from your mobile property, select the Extensions tab.
  2. 2.
    On the Catalog tab, locate or search for the Places extension, and select Install.
  3. 3.
    Select the POI Library (or libraries) you wish to use in the app.
  4. 4.
    Select Save.
  5. 5.
    Follow the publishing process to update SDK configuration.
Places extension configuration

Add the AEP Places extension to your app

Download and import the Places extension

Android
iOS (AEP 3.x)
iOS (ACP 2.x)

Java

  1. 1.
    Add the Mobile Core and Places extensions to your project using the app's Gradle file.
1
implementation 'com.adobe.marketing.mobile:core:1.+'
2
implementation 'com.adobe.marketing.mobile:places:1.+'
Copied!
  1. 1.
    Import the Mobile Core and Places extensions in your Application class.
1
import com.adobe.marketing.mobile.MobileCore;
2
import com.adobe.marketing.mobile.Places;
Copied!
  1. 1.
    Add the Mobile Core and Places extensions to your project using CocoaPods. Add the following pods in your Podfile:
1
use_frameworks!
2
target 'YourTargetApp' do
3
pod 'AEPCore'
4
pod 'AEPPlaces'
5
end
Copied!
  1. 1.
    Import the Mobile Core and Places modules:

Swift

1
// AppDelegate.swift
2
import AEPCore
3
import AEPPlaces
Copied!

Objective-C

1
// AppDelegate.h
2
@import AEPCore;
3
@import AEPPlaces;
Copied!
  1. 1.
    Add the Mobile Core and Places extensions to your project using CocoaPods. Add the following pods in your Podfile:
1
use_frameworks!
2
target 'YourTargetApp' do
3
pod 'ACPCore', '~> 2.0'
4
pod 'ACPPlaces', '~> 1.0'
5
end
Copied!
  1. 1.
    Import the Mobile Core and Places modules:

Swift

1
// AppDelegate.swift
2
import ACPCore
3
import ACPPlaces
Copied!

Objective-C

1
// AppDelegate.h
2
#import "ACPCore.h"
3
#import "ACPPlaces.h"
Copied!

Register the Places extension with Mobile Core

Android
iOS (AEP 3.x)
iOS (ACP 2.x)

Java

1
public class MobileApp extends Application {
2
3
@Override
4
public void onCreate() {
5
super.onCreate();
6
MobileCore.setApplication(this);
7
try {
8
Places.registerExtension();
9
// register other extensions
10
MobileCore.start(new AdobeCallback () {
11
@Override
12
public void call(Object o) {
13
MobileCore.configureWithAppID("yourAppId");
14
}
15
});
16
} catch (Exception e) {
17
//Log the exception
18
}
19
}
20
}
Copied!

Swift

1
// AppDelegate.swift
2
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
3
MobileCore.registerExtensions([Places.self], {
4
MobileCore.configureWith(appId: "yourLaunchEnvironmentID")
5
})
6
...
7
}
Copied!

Objective-C

1
// AppDelegate.m
2
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
3
[AEPMobileCore registerExtensions:@[AEPMobilePlaces.class] completion:^{
4
...
5
}];
6
[AEPMobileCore configureWithAppId: @"yourLaunchEnvironmentID"];
7
...
8
}
Copied!

Swift

1
// AppDelegate.swift
2
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
3
ACPPlaces.registerExtension()
4
ACPCore.configure(withAppId: "yourLaunchEnvironmentID")
5
ACPCore.start()
6
})
7
...
8
}
Copied!

Objective-C

1
// AppDelegate.m
2
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
3
[ACPPlaces registerExtension];
4
[ACPCore configureWithAppId:@"yourLaunchEnvironmentID"];
5
[ACPCore start];
6
...
7
}
Copied!