Links
📍

Geolocation

If you're planning to use browser Geolocation API, make sure you've enabled the Geolocation feature for iOS (For Android, this feature is enabled by default)

🧋 Bubble.io Plugin

[Element] Natively - Location

Natively - Location element contains Foreground & Background location services:

📍 Foreground Location Tracking

Events:

  • Location received - User's location longitude & latitude values updated.
  • Location failed - called whenever Location service was not able to get user's location (check Latest location request status for more details)
  • Location Permission Received - called whenever Get location permission return a result

States:

  • Latest location longitude - Longitude as number
  • Latest location latitude - Latitude as number
  • Latest location response status - Status of the latest geolocation request call.
    • SUCCESS - Got a location and desired accuracy level was achieved successfully.
    • TIMEOUT - Got a location, but the desired accuracy level was not reached before timeout.
    • FAILED - An error occurred while using the system location services.
  • Location permission
    • IN_USE - foreground allowed
    • ALWAYS - background allowed
    • DENIED - not determined or denied

Actions:

  • Get current location
    • Accuracy [iOS] - Radius in meters.
    • Priority [Android] - "BALANCED" (To save battery, recommended) & "HIGH"
  • Start foreground location service - start fetching device location
    • Accuracy [iOS] - Radius in meters.
    • Priority [Android] - "BALANCED" (To save battery, recommended) & "HIGH"
    • Fetching Interval - Determines how often the location will be fetched. Interval in milliseconds. 5000ms -> 5s
  • Stop foreground location service - stop fetching device location
  • Get location permission - request location permission status update
On page reload, the location live tracking service will be automatically stopped. You need to run the Start live location service action.

🚙 Background location tracking (BETA) - v2.1.0

Before using background geolocation, make sure you've enabled it in your Natively App Dashboard + Created a new build.

States:

  • Latest location response status - Status of the latest background location service start/stop.
    • SUCCESS - Background location started/stopped successfully
    • FAILED - Background location started/stopped with an error.

Events:

  • Location background failed - Whenever starting of background service will fail
  • Location background success - Whenever starting of background service will succeed

Actions:

  • Start background location service - start fetching device location
    • Accuracy [iOS] - Radius in meters.
    • Priority [Android] - "BALANCED" (To save battery, recommended) & "HIGH"
    • Fetching Interval - Determines how often the location will be fetched. Interval in milliseconds. 5000ms -> 5s
    • Response Identifier - Identifier that will be sent with a user's location (We're recommending using the user's unique id)
  • Stop background location service - stop fetching device location
Background geolocation can be automatically stopped in such cases: If the user or system closes the app, or if the device receives more than 3 errors in response from your endpoint.
Unlike foreground location service, the background will not stop on page reload

Coordinates -> Marker address

To convert longitude and latitude to the bubble's geolocation, you need to use this formula:
​

🛠 JavaScript SDK

NativelyLocation

1
const locationService = new NativelyLocation()
2
const location_callback = function (resp) {
3
console.log(resp.status); // "Success"/"Timeout"/"Error"
4
console.log(resp.longitude); // 50.1231231
5
console.log(resp.latitude); // 50.1231231
6
};
7
const accuracy_ios = 5 // (in meters) [iOS only]
8
const priority_android = "BALANCED" // "BALANCED" or "HIGH" [Android only]
9
const inerval = 50000 // in milliseconds
10
// Foreground Location
11
locationService.current(accuracy_ios, priority_android, location_callback);
12
locationService.start(interval, accuracy_ios, priority_android, location_callback);
13
locationService.stop();
14
​
15
const location_bg_callback = function (resp) {
16
console.log(resp.status); // "SUCCESS"/"FAILED" - Start of background service was successfully or failed
17
};
18
// Background Location
19
const responseId = "my-user-id" // Identifer that you will receive together with coordinates to your webhook endpoint
20
locationService.startBackground(interval, accuracy_ios, priority_android, responseId, location_bg_callback);
21
locationService.stopBackground(location_bg_callback);
​