voltmx.location Namespace

function successcallback1() {
    alert("All location settings are satisfied. The client can initialize location requests now.");
  }

  function errorcallback1(errorCode) {
    if (errorCode == voltmx.location.SETTINGS_RESOLUTION_REQUIRED) {
        alert("Location settings are not satisfied. Call this API again by setting requestModifyLocationSettings value to true then it will show the user a dialog to resolve location settings.");
    } else if (errorCode == voltmx.location.SETTINGS_MODIFICATION_REQUEST_DENIED) {
        alert("The user denied the settings change.");
    }
  }
  var params = {
    requestModifyLocationSettings: true,
    accuracyMode: constants.ACCURACY_BALANCED_POWER,
    onSuccess: successcallback1,
    onFailure: errorcallback1
  };
  voltmx.location.checkLocationSettings(params);

voltmx.location.clearWatch(watchID);
  

stopWatchingPosition: function() {
    try {
        voltmx.location.clearWatch(this.watchID); // clears/stops watching position of the user which was being monitored using watchPosition API
        alert("Cleared !");
    } catch (exception) {
        alert(exception);
    }

    /* Please see example of clearWatch() in "frmTrackingUserLocation" Form of [sample app](http://docs.voltmx.com/voltmxlibrary/iris/zip/sampleapps/LocationApp.zip) */
  }
  

function stopWatchingPosition () {
  try{
    voltmx.location.clearWatch(watchID); // clears/stops watching position of the user which was being monitored using watchPosition API
    alert("Cleared !");
  }catch(exception){
    alert(exception);
  }
  }

/******************************************************************
  *	Name   : getCurrentPosition function
  *	Author  : VoltMX
  *	Purpose : This function helps to get the current location
  *******************************************************************/
  function getPosition() {
    var positionoptions = {
        timeout: 15000
    }; // 15 secs 
    positionoptions.enableHighAccuracy = true;
    voltmx.location.getCurrentPosition(successcallback, errorcallback, positionoptions);
  }

  // Callback that is executed on success of getCurrentPosition function.
  function successcallback(position) {
    var geoPosition = "Latitude: " + position.coords.latitude;
    geoPosition = geoPosition + " Longitude: " + position.coords.longitude;
    geoPosition = geoPosition + " Altitude: " + position.coords.altitude;
    geoPosition = geoPosition + " Accuracy: " + position.coords.accuracy;
    geoPosition = geoPosition + " Altitude Accuracy: " + position.coords.altitudeAccuracy;
    geoPosition = geoPosition + " Heading: " + position.coords.heading;
    geoPosition = geoPosition + " Speeding: " + position.coords.speeding;
    geoPosition = geoPosition + " Timestamp: " + position.timestamp;
    alert(geoPosition);
  }

  // Callback that is executed on error of getCurrentPosition function.
  function errorcallback(positionerror) {
    var errorMesg = "Error code: " + positionerror.code;
    errorMesg = errorMesg + " message: " + positionerror.message;
    alert(errorMesg);
  }
  

currentPositionSuccessCallback: function(position) {
    /* 
  //  position object will have the below properties .
         latitude = position.coords.latitude 
         longitude = position.coords.longitude
         altitude = position.coords.altitude
         atitudeAccuracy = position.coords.altitudeAccuracy
         heading = position.coords.heading
         speeding = position.coords.speeding
         timestamp = position.timestamp
    */
    alert(JSON.stringify(position));
    /* use the position depending on the use case ,some of the use cases are listed below .    
	1. Get the nearby events(like ATMs, Restaurants …etc.)  based on the user current location
	2. In a tracking-based scenario ,use as an initial position of the user .
	*/

  },
  currentPositionFailureCallback: function(error) {
    alert(JSON.stringify(error));
  },
  getCurrentPositionOfDevice: function() {
    var options = {};
    options.enableHighAccuracy = true; //  uses provider that gets accurate location
    options.timeout = 10000; // timeout in milliseconds  
    options.requireBackgroundAccess  = true; // gets the location updates in the background as well
    voltmx.location.getCurrentPosition(this.currentPositionSuccessCallback, this.currentPositionFailureCallback, options);
  }

  /* Please see example of getCurrentPosition() in "frmTrackingUserLocation" Form of [sample app](http://docs.voltmx.com/voltmxlibrary/iris/zip/sampleapps/LocationApp.zip)*/
  

function currentPositionSuccessCallback(position) {
  /* 
	// position object will have the below properties .
   	latitute = position.coords.latitude
    longitude = position.coords.longitude
    altitude = position.coords.altitude
    atitudeAccuracy = position.coords.altitudeAccuracy
    heading = position.coords.heading
    speeding = position.coords.speeding
    timestamp = position.timestamp
	*/
  alert(JSON.stringify(position));
  /* use the position depending on the use case ,some of the use cases are listed below .    
	1. Get the nearby events(like ATMs, Restaurants …etc.)  based on the user current location
	2. In a tracking-based scenario ,use as an initial position of the user .
	*/

  }

  function currentPositionFailureCallback(error) {
    alert(JSON.stringify(error));
  }

  function getCurrentPositionOfDevice () {
    var options = {};
    options.enableHighAccuracy = true; 
    options.timeout = 10000; // timeout in milli seconds      
   options.requireBackgroundAccess  = true; // gets the location updates in the background as well
    voltmx.location.getCurrentPosition(currentPositionSuccessCallback, currentPositionFailureCallback, options);
  }

function successcallback1(position) {
      lblTest.text = "working with watchPosition success full call back";
      var geoPosition = "Latitude: " + position.coords.latitude;
      geoPosition = geoPosition + " Longitude: " + position.coords.longitude;
      geoPosition = geoPosition + " Altitude: " + position.coords.altitude;
      geoPosition = geoPosition + " Accuracy: " + position.coords.accuracy;
      geoPosition = geoPosition + " Altitude Accuracy: " + position.coords.altitudeAccuracy;
      geoPosition = geoPosition + " Heading: " + position.coords.heading;
      geoPosition = geoPosition + " Speeding: " + position.coords.speeding;
      geoPosition = geoPosition + " Timestamp: " + position.timestamp;
      alert(geoPosition);
  }

  function errorcallback1(positionerror) {
      lblTest.text = "working with watchPosition err call back";
      var errorMesg = "Error code: " + positionerror.code;
      errorMesg = errorMesg + " message: " + positionerror.message;
      alert(errorMesg);
  }
  var positionoptions = {
      maximumAge: 3000,
      minimumDistance: 5,
      minimumTime: 5000
  };
  watchID = voltmx.location.watchPosition(successcallback1, errorcallback1, positionoptions);
  

watchID: null,
    watchPositionSuccessCallback: function(position) {
      /* 
      // position object will have the below properties .
          latitute = position.coords.latitude
        longitude = position.coords.longitude
        altitude = position.coords.altitude
        atitudeAccuracy = position.coords.altitudeAccuracy
        heading = position.coords.heading
        speeding = position.coords.speeding
        timestamp = position.timestamp
      */
      alert(JSON.stringify(position));
    },
    watchPositionFailureCallback: function(error) {
      alert(JSON.stringify(error));
    },
    watchPositionOfDevice: function() {
      var self = this;
      var options = {};
      options.maximumAge = 1000;
      options.minimumTime = 2000; // time in milli seconds
      options.minimumDistance = 2; // distance in meters   
     options.requireBackgroundAccess  = true; // gets the location updates in the background as well
      this.watchID = voltmx.location.watchPosition(this.watchPositionSuccessCallback,this.watchPositionFailureCallback, options);
      /* Use-Cases:
    In tracking-based scenarios, the watchPosition() API can be used to 
      monitor a position
    */
    
    /*Please see example of watchPosition() in "frmTrackingUserLocation" Form of [sample app](http://docs.voltmx.com/voltmxlibrary/iris/zip/sampleapps/LocationApp.zip)*/
    }

watchID = null;

  function watchPositionSuccessCallback(position) {
      /* 
          // position object will have the below properties .
        latitute = position.coords.latitude
        longitude = position.coords.longitude
        altitude = position.coords.altitude
        atitudeAccuracy = position.coords.altitudeAccuracy
        heading = position.coords.heading
        speeding = position.coords.speeding
        timestamp = position.timestamp
        */

      alert(JSON.stringify(position));
  }

  function watchPositionFailureCallback(error) {
      alert(JSON.stringify(error));
  }

  function watchPositionOfDevice() {
      var self = this;
      var options = {};
      options.maximumAge = 1000; // use cached position if exists in mentioned time(in milliseconds)
      options.minimumTime = 2000; // time criteria for location updates
      options.minimumDistance = 2; // distance criteria for location updates   
     options.requireBackgroundAccess  = true; // gets the location updates in the background as well
      watchID = voltmx.location.watchPosition(watchPositionSuccessCallback, watchPositionFailureCallback, options);
  }