Places support

10 min

Places Service, previously known as Adobe Experience Platform Location Service, is a geolocation service that enables location-aware mobile apps to understand location context using rich, easy-to-use SDK interfaces and a flexible database of points of interest (POIs).

Places Service allows us to :

Create and manage a database of POIs that can be leveraged with other Adobe Experience Cloud solutions.

Configure the SDK in Adobe Experience Platform Launch to define location-triggered rules and metadata-based conditions.

Reduce the code that we need to write to monitor a device’s location and use the Places extension to automatically trigger the location-specific rules.

Manage libraries

1.Go to Data Collection. Click on Places under Data Management.

2.On the top right side, click … > Manage Libraries.

3.Click New. Provide a name and click Confirm.

Create a POI

1.In the top right side, click New.

2.Provide a name for the POI. Enter or select a radius.

3.The following steps are optional:

Select an icon for your POI.

Select a color for the icon.

Specify a category for your POI.

4.Expand the Location section.

Type an address.

Type the city.

Type the name of the state.

Type the name of the country.

Select or enter a latitude or longitude (required).

Click

If you do not know the exact latitude and longitude, dropping a pin is useful.

Install Places extension

Go to Data Collection and open the property.

Click on Extensions tab.

On the Catalog tab, locate the Places extension, and click Install.

4.Select the Places libraries you want to use in this property. These are the libraries that will be accessible in your app. Click Save.

Create a rule:

With the Places extension and a region monitoring solution installed in your mobile application, you can create rules in Adobe Experience Platform Launch that are triggered or conditioned location data including location entry and exit events.

1.Create new Rule called e.g. "Enter POI"

2.Add an event as below:

Extension: Places

Event Type: Enter POI

Name: Places - Enter POI

3.Add an action as below:

Extension: Mobile Core

Action Type: Send Postback

Name: Mobile Core - Send Postback

Url: Provide web hook url to which message should be sent.

Post Body:

{ "text": "DSN entered POI region {%~state.com.adobe.module.places/lastenteredpoi.regionname%}." }

This is a basic rule for tesing poi entry by sending slack notifications.

Note: Advanced usecase -You can also add "Attach Data" to send poi.entry event to trigger push notifications.

{ "xdm": { "eventType": "poi.entry", "_demosystem4": { "identification": { "core": { "ecid": "{%%ECID}" } } } } }

4.Complete the publishing process to update the SDK configuration.

Use Adobe Experience Platform Assurance for Places Service

1.Go to Data Collection and click on Assurance.

2.Connect app to assurance session. To learn more : https://dsn.adobe.com/docs/use-assurance

3.From the left side menu, select the Map & Simulate.

4.On the map find your desired area and click "Simulate Load POIs"

5.Click on the pin that will show up and click "Simulate Entry Event".

6.The mobile app will receive this event and a notification will be sent to the slack channel.