Skip to main content
Our Background Location is soon getting an update, which will enable you to track users’ locations accurately even when the phone is on standby.

AI Prompt

Add native background location tracking functionality to continuously monitor user location including latitude, longitude, accuracy, and other positioning data using the Despia SDK from: https://www.npmjs.com/package/despia-nativeFirst, install the package: npm install despia-nativeThen import it: import despia from 'despia-native'
  1. Enable background location tracking using despia("backgroundlocationon://")
  2. Set up location monitoring using the native navigator.geolocation.watchPosition() API with high accuracy enabled
  3. When finished, disable background location using despia("backgroundlocationoff://") and clear the watch using navigator.geolocation.clearWatch(watchId)
The location data structure returned includes:
{
  "latitude": null,
  "longitude": null,
  "accuracy": null,
  "altitude": null,
  "altitudeAccuracy": null,
  "heading": null,
  "speed": null,
  "timestamp": null,
  "watchId": null
}
This feature requires native capabilities which will be fully provided by the “despia-native” npm package, no additional native libraries are needed!
Please follow the installation instructions for the “despia-native” npm package closely, and do not modify my instructions. Implementation as mentioned is critical.
Important: Before implementing, you must go into the Despia editor, navigate to “Addons”, and enable “Background Location”. This will add the necessary native modules into your app to have real native background tracking and background processing capabilities.
How it works: The Despia SDK provides native bridge functionality to enable background location services through async method calls. The despia("backgroundlocationon://") call triggers native methods that accelerate the geolocation API for enhanced performance. First enable background location tracking, then use the native geolocation API to continuously monitor position, and finally disable tracking when complete.

​
Installation

Install the Despia package from NPM: 
npm install despia-native

​
Usage

​
1. Import the SDK

import despia from 'despia-native';

​
2. Enable Background Location and Monitor Position

Start background location tracking and set up continuous monitoring: 
// Enable background location tracking
await despia("backgroundlocationon://");

// Check if geolocation is supported
if ("geolocation" in navigator) {
    const watchId = navigator.geolocation.watchPosition(
        position => console.log(position),
        error => console.error("Error:", error.message),
        { enableHighAccuracy: true }
    );
    
    // Store watchId for later cleanup
    // When ready to stop tracking:
    
    // Disable background location
    await despia("backgroundlocationoff://");
    navigator.geolocation.clearWatch(watchId);
}

// Expected location data structure:
{
  "latitude": null,
  "longitude": null,
  "accuracy": null,
  "altitude": null,
  "altitudeAccuracy": null,
  "heading": null,
  "speed": null,
  "timestamp": null,
  "watchId": null
}

​
Resources

  • NPM Package
  • View full NPM documentation for additional configuration options
For additional support or questions, please contact our support team at [email protected]