| Index: content/public/browser/location_provider.h
|
| diff --git a/content/public/browser/location_provider.h b/content/public/browser/location_provider.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..8752a902e1e91462a0398b835388cba5618d69a9
|
| --- /dev/null
|
| +++ b/content/public/browser/location_provider.h
|
| @@ -0,0 +1,58 @@
|
| +// 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_PUBLIC_BROWSER_LOCATION_PROVIDER_H_
|
| +#define CONTENT_PUBLIC_BROWSER_LOCATION_PROVIDER_H_
|
| +
|
| +#include "base/callback.h"
|
| +#include "base/compiler_specific.h"
|
| +#include "content/public/common/geoposition.h"
|
| +
|
| +namespace content {
|
| +
|
| +class LocationProvider;
|
| +
|
| +// The interface for providing location information.
|
| +class LocationProvider {
|
| + public:
|
| + virtual ~LocationProvider() {}
|
| +
|
| + typedef base::Callback<void(const LocationProvider*, const Geoposition&)>
|
| + LocationProviderUpdateCallback;
|
| +
|
| + // This callback will be used to notify when a new Geoposition becomes
|
| + // available.
|
| + virtual void SetUpdateCallback(
|
| + const LocationProviderUpdateCallback& callback) = 0;
|
| +
|
| + // StartProvider maybe called multiple times, e.g. to alter the
|
| + // |high_accuracy| setting. Returns false if a fatal error was encountered
|
| + // which prevented the provider from starting.
|
| + 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;
|
| +
|
| + // 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_PUBLIC_BROWSER_LOCATION_PROVIDER_H_
|
|
|