1// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CONTENT_BROWSER_GEOLOCATION_LOCATION_ARBITRATOR_H_
6#define CONTENT_BROWSER_GEOLOCATION_LOCATION_ARBITRATOR_H_
7
8#include "content/common/content_export.h"
9
10namespace content {
11
12// This class is responsible for handling updates from multiple underlying
13// providers and resolving them to a single 'best' location fix at any given
14// moment.
15class CONTENT_EXPORT LocationArbitrator {
16public:
17  virtual ~LocationArbitrator() {};
18
19  // See more details in geolocation_provider.
20  virtual void StartProviders(bool use_high_accuracy) = 0;
21  virtual void StopProviders() = 0;
22
23  // Called everytime permission is granted to a page for using geolocation.
24  // This may either be through explicit user action (e.g. responding to the
25  // infobar prompt) or inferred from a persisted site permission.
26  // The arbitrator will inform all providers of this, which may in turn use
27  // this information to modify their internal policy.
28  virtual void OnPermissionGranted() = 0;
29
30  // Returns true if this arbitrator has received at least one call to
31  // OnPermissionGranted().
32  virtual bool HasPermissionBeenGranted() const = 0;
33};
34
35}  // namespace content
36
37#endif  // CONTENT_BROWSER_GEOLOCATION_LOCATION_ARBITRATOR_IMPL_H_
38