Location tracking
This article shows how to configure location tracking for your Android or FireOS application.
Add at least one of the following permissions to your AndroidManifest.xml file to declare your app’s intent to collect location data:
1
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
1
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
ACCESS_FINE_LOCATION includes GPS data in reporting user location while ACCESS_COARSE_LOCATION includes data from the most battery-efficient non-GPS provider available (for example, the network). Coarse location will likely be sufficient for most location data use-cases; however, under the runtime permissions model, receiving location permission from the user implicitly authorizes the collection of fine location data. Take a look at Location Strategies from Android Developers to read more about the differences between these location permissions and how you should use them.
With the release of Android M, Android switched from an install-time to a runtime permissions model. To enable location tracking on devices running Android M or later, the app must explicitly receive permission to use the location from the user (Braze will not do this). After location permissions are obtained, Braze will automatically begin tracking location on the next session start if location collection is enabled in braze.xml. Devices running earlier versions of Android only require location permissions to be declared in the AndroidManifest.xml. For more information, visit Android’s permission documentation.
Disabling automatic location tracking
Compile-time Option
To disable automatic location tracking at compile time, set com_braze_enable_location_collection to false in braze.xml:
1
<bool name="com_braze_enable_location_collection">false</bool>
Runtime Option
To selectively disable automatic location tracking at runtime, use BrazeConfig:
1
2
3
4
BrazeConfig brazeConfig = new BrazeConfig.Builder()
.setIsLocationCollectionEnabled(false)
.build();
Braze.configure(this, brazeConfig);
1
2
3
4
val brazeConfig = BrazeConfig.Builder()
.setIsLocationCollectionEnabled(false)
.build()
Braze.configure(this, brazeConfig)
Manually Logging Location
Even when automatic tracking is disabled, you can manually log single location data points via the setLastKnownLocation() method on BrazeUser like this:
1
Braze.getInstance(context).getCurrentUser().setLastKnownLocation(LATITUDE_DOUBLE_VALUE, LONGITUDE_DOUBLE_VALUE, ALTITUDE_DOUBLE_VALUE, ACCURACY_DOUBLE_VALUE);
1
Braze.getInstance(context).currentUser?.setLastKnownLocation(LATITUDE_DOUBLE_VALUE, LONGITUDE_DOUBLE_VALUE, ALTITUDE_DOUBLE_VALUE, ACCURACY_DOUBLE_VALUE)
Edit this page on GitHub