Add a mechanism to pause and resume geolocation requests.

content/port/browser/location_provider.h

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PORT_BROWSER_LOCATION_PROVIDER_H_
 #define CONTENT_PORT_BROWSER_LOCATION_PROVIDER_H_
 
 #include "base/callback.h"
 #include "base/compiler_specific.h"
 #include "content/public/common/geoposition.h"
@@ skipping 21 matching lines @@
   virtual bool StartProvider(bool high_accuracy) = 0;
 
   // Stops the provider from sending more requests.
   // Important: a LocationProvider may be instantiated and StartProvider() may
   // be called before the user has granted permission via OnPermissionGranted().
   // This is to allow underlying providers to warm up, load their internal
   // libraries, etc. No |LocationProviderUpdateCallback| can be run and no
   // network requests can be done until OnPermissionGranted() has been called.
   virtual void StopProvider() = 0;
 
+  // The LocationProvider implementation may use the Pause/ResumeProvider API
+  // to temporarily stop this provider from firing updates. By default, these
+  // APIs are a no-op.
+  virtual void PauseProvider() = 0;
+  virtual void ResumeProvider() = 0;
+
   // Gets the current best position estimate.
   virtual void GetPosition(Geoposition* position) = 0;
 
   // Provides a hint to the provider that new location data is needed as soon
   // as possible.
   virtual void RequestRefresh() = 0;
 
   // Called everytime permission is granted to a page for using geolocation.
   // This may either be through explicit user action (e.g. responding to the
   // infobar prompt) or inferred from a persisted site permission.
   // Note: See |StartProvider()| for more information.
   virtual void OnPermissionGranted() = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PORT_BROWSER_LOCATION_PROVIDER_H_