Background Location

Temporary Documentation - Final Version Coming Soon!

  1. Call Despia SDK - Enable Background Location

    window.despia = "backgroundlocationon://"
    
  2. Listen for Background Location Updates

    const options = {
        enableHighAccuracy: true,  // Use GPS for better accuracy (uses more battery)
        timeout: 5000,             // How long to wait for a reading (milliseconds)
        maximumAge: 5000           // Accept cached positions up to this age (milliseconds)
    };
    
    const watchId = navigator.geolocation.watchPosition(
        (position) => {
            // Update Wized variable with new location
            v.location = {
                latitude: position.coords.latitude,
                longitude: position.coords.longitude,
                accuracy: position.coords.accuracy,
                altitude: position.coords.altitude,
                altitudeAccuracy: position.coords.altitudeAccuracy,
                heading: position.coords.heading,
                speed: position.coords.speed,
                timestamp: position.timestamp,
                watchId: watchId
            };
        },
        (error) => {
            console.error("Error:", error.message);
            // Optional error handling
        }, 
        options
    );
    
    • Sample Data Structure for Variable:

      {
          "latitude": null,
          "longitude": null,
          "accuracy": null,
          "altitude": null,
          "altitudeAccuracy": null,
          "heading": null,
          "speed": null,
          "timestamp": null,
          "watchId": null
      }
      
  3. Call Despia SDK - Stop Background Location

    window.despia = "backgroundlocationoff://"
    
  4. Stop Watching Location Changes

    const watchId = v.location.watchId // Get from Wized variable
    navigator.geolocation.clearWatch(watchId);
    
Updated on