[TIMOB-10965] iOS: Feature: Add property to determine if the app is being launched by the OS or by the user

   var locationUpdated = false;
   var args = Ti.App.getArguments();
   if(args.launchOptionsLocationKey == true)
   {
       var notification = Ti.App.iOS.scheduleLocalNotification({
           alertBody:"Location Update from background received \n",
           alertAction:"Re-Launch!",
           date:new Date(new Date().getTime() ) 
       });
       locationUpdated = true; 
   }
   Ti.API.info('Ti.App.getArguments() ::'+args);
    
   Ti.App.addEventListener('resumed',function(){
        
       Ti.API.info("app has resumed from the background");
       if(args.launchOptionsLocationKey == true)
       {
           var notification = Ti.App.iOS.scheduleLocalNotification({
               alertBody:"Location Update from background received \n",
               alertAction:"Re-Launch!",
               date:new Date(new Date().getTime() ) 
           });
           locationUpdated = true; 
       }
       Ti.API.info('Ti.App.getArguments() ::'+Ti.App.getArguments());
   });
     
   Titanium.App.addEventListener('pause',function(e)
   {
       alert(JSON.stringify(e));
       Ti.API.info("PAUSED");      
   });
      
   //setting up the GPS necessary stuff
    
   Ti.Geolocation.preferredProvider = "gps";
          
   Ti.Geolocation.purpose = "GPS demo for startmonitoringlocationupdates";
          
   function translateErrorCode(code) {
       if (code == null) {
           return null;
       }
       switch (code) {
           case Ti.Geolocation.ERROR_LOCATION_UNKNOWN:
               return "Location unknown";
           case Ti.Geolocation.ERROR_DENIED:
               return "Access denied";
           case Ti.Geolocation.ERROR_NETWORK:
               return "Network error";
           case Ti.Geolocation.ERROR_HEADING_FAILURE:
               return "Failure to detect heading";
           case Ti.Geolocation.ERROR_REGION_MONITORING_DENIED:
               return "Region monitoring access denied";
           case Ti.Geolocation.ERROR_REGION_MONITORING_FAILURE:
               return "Region monitoring access failure";
           case Ti.Geolocation.ERROR_REGION_MONITORING_DELAYED:
               return "Region monitoring setup delayed";
       }
   }   
    
   //  SHOW CUSTOM ALERT IF DEVICE HAS GEO TURNED OFF
   //
   if (Titanium.Geolocation.locationServicesEnabled === false)
   {
       Titanium.UI.createAlertDialog({title:'Kitchen Sink', message:'Your device has geo turned off - turn it on.'}).show();
   }
   else
   {
       var authorization = Titanium.Geolocation.locationServicesAuthorization;
       Ti.API.info('Authorization: '+authorization);
       if (authorization == Titanium.Geolocation.AUTHORIZATION_DENIED) {
           Ti.UI.createAlertDialog({
               title:Titanium.App.getName(),
               message:'You have disallowed Titanium from running geolocation services.'
           }).show();
       }
       else if (authorization == Titanium.Geolocation.AUTHORIZATION_RESTRICTED) {
           Ti.UI.createAlertDialog({
               title:Titanium.App.getName(),
               message:'Your system has disallowed Titanium from running geolocation services.'
           }).show();
       }
      
      
            
        
      
       //
       //  SET ACCURACY - THE FOLLOWING VALUES ARE SUPPORTED
       //
       // Titanium.Geolocation.ACCURACY_BEST
       // Titanium.Geolocation.ACCURACY_NEAREST_TEN_METERS
       // Titanium.Geolocation.ACCURACY_HUNDRED_METERS
       // Titanium.Geolocation.ACCURACY_KILOMETER
       // Titanium.Geolocation.ACCURACY_THREE_KILOMETERS
       //
       Titanium.Geolocation.accuracy = Titanium.Geolocation.ACCURACY_BEST;
      
       //
       //  SET DISTANCE FILTER.  THIS DICTATES HOW OFTEN AN EVENT FIRES BASED ON THE DISTANCE THE DEVICE MOVES
       //  THIS VALUE IS IN METERS
       //
       Titanium.Geolocation.distanceFilter = 10;
      
       //The app was turned on while in background.Should only set up the LocationManager to track Significant changes only.
       if(locationUpdated == true){
       	Titanium.Geolocation.trackSignificantLocationChange = true;
       }
        
       //
       // EVENT LISTENER FOR GEO EVENTS - THIS WILL FIRE REPEATEDLY (BASED ON DISTANCE FILTER)
       //
       var locationCallback = function(e)
       {
           if (!e.success || e.error)
           {
               updatedLocation.text = 'error:' + JSON.stringify(e.error);
               updatedLatitude.text = '';
               updatedLocationAccuracy.text = '';
               updatedLocationTime.text = '';
               Ti.API.info("Code translation: "+translateErrorCode(e.code));
               return;
           }
      
           var longitude = e.coords.longitude;
           var latitude = e.coords.latitude;
           var altitude = e.coords.altitude;
           var heading = e.coords.heading;
           var accuracy = e.coords.accuracy;
           var speed = e.coords.speed;
           var timestamp = e.coords.timestamp;
           var altitudeAccuracy = e.coords.altitudeAccuracy;
      
           //Titanium.Geolocation.distanceFilter = 100; //changed after first location event
             if(locationUpdated == false){
        
               updatedLocation.text = 'long:' + longitude;
               updatedLatitude.text = 'lat: '+ latitude;
               updatedLocationAccuracy.text = 'accuracy:' + accuracy;
               updatedLocationTime.text = 'timestamp:' +new Date(timestamp);
          
               updatedLatitude.color = 'red';
               updatedLocation.color = 'red';
               updatedLocationAccuracy.color = 'red';
               updatedLocationTime.color = 'red';
               setTimeout(function()
               {
                   updatedLatitude.color = '#444';
                   updatedLocation.color = '#444';
                   updatedLocationAccuracy.color = '#444';
                   updatedLocationTime.color = '#444';
          
               },100);
          
           }
           else
           {
                   var notification = Ti.App.iOS.scheduleLocalNotification({
                       alertBody:"Location Update Received.",
                       alertAction:"Re-Launch!",
                       userInfo:{"hello":"world"},
                       sound:"pop.caf",
                       date:new Date(new Date().getTime() + 3000) // 3 seconds after backgrounding
                   });
           }        
      
           Titanium.API.info('geo - location updated: ' + new Date(timestamp) + ' long ' + longitude + ' lat ' + latitude + ' accuracy ' + accuracy);
       };
       Titanium.Geolocation.addEventListener('location', locationCallback);
       locationAdded = true;
   }
    
    
    
   //Create the UI only if the app opened as a consequence of User interaction with the app.
    
   if(locationUpdated == false)
   {
       var win = Titanium.UI.createWindow({
           backgroundColor:'white'
       });
    
       var updatedLocationLabel = Titanium.UI.createLabel({
           text:'Updated Location',
           font:{fontSize:12, fontWeight:'bold'},
           color:'#111',
           top:150,
           left:10,
           height:15,
           width:300
       });
       win.add(updatedLocationLabel);
          
       var updatedLocation = Titanium.UI.createLabel({
           text:'Updated Location not fired',
           font:{fontSize:11},
           color:'#444',
           top:170,
           left:10,
           height:15,
           width:300
       });
       win.add(updatedLocation);
          
       var updatedLatitude = Titanium.UI.createLabel({
           text:'',
           font:{fontSize:11},
           color:'#444',
           top:190,
           left:10,
           height:15,
           width:300
       });
       win.add(updatedLatitude);
          
       var updatedLocationAccuracy = Titanium.UI.createLabel({
           text:'',
           font:{fontSize:11},
           color:'#444',
           top:210,
           left:10,
           height:15,
           width:300
       });
       win.add(updatedLocationAccuracy);
          
       var updatedLocationTime = Titanium.UI.createLabel({
           text:'',
           font:{fontSize:11},
           color:'#444',
           top:230,
           left:10,
           height:15,
           width:300
       });
       win.add(updatedLocationTime);
          
        
          
       var button = Ti.UI.createButton({
           title:'Track Significant Location Change(TSLC)',
           width:Ti.UI.SIZE,
           height:Ti.UI.SIZE,
           backgroundColor: '',
           bottom:70
       });
       button.addEventListener('click',function(){
           var val = Ti.Geolocation.trackSignificantLocationChange;
           Ti.Geolocation.trackSignificantLocationChange = !val;
       });
       win.add(button);
       //Check track significant value
       var button2 = Ti.UI.createButton({
           title:'Check value of TSLC',
           width:Ti.UI.SIZE,
           height:Ti.UI.SIZE,
           backgroundColor: 'grey',
           bottom:5
       });
       button2.addEventListener('click',function(){
           var value = Ti.Geolocation.trackSignificantLocationChange;
           Ti.API.info('---> Ti.Geolocation.trackingSignificantLocationChange ?'+ value);
           Titanium.UI.createAlertDialog({title:'GPS',message:'trackingSignificantLocationChange:'+value}).show();
          
       });
       win.add(button2);
          
       // state vars used by resume/pause
       //var headingAdded = false;
       var locationAdded = false;
          
        
       var addr = "2065 Hamilton Avenue San Jose California 95125";
       win.open();
   }
   else{
        Titanium.Geolocation.addEventListener('location', locationCallback);
        locationAdded = true;
   }