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 (e.g., 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 utilize 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). Once 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
To disable automatic location tracking at compile time, set
1 <bool name="com_braze_enable_location_collection">false</bool>
To selectively disable automatic location tracking at runtime, use
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)