Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(138)

Side by Side Diff: device/geolocation/geolocation_provider.h

Issue 2192683003: Revert of Reland: Geolocation: move from content/browser to device/ (patchset #2 id:20001 of https:… (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@2810
Patch Set: Created 4 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « device/geolocation/geolocation_export.h ('k') | device/geolocation/geolocation_provider_impl.h » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
(Empty)
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 DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_
6 #define DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_
7
8 #include <memory>
9
10 #include "base/callback_list.h"
11 #include "device/geolocation/geolocation_export.h"
12
13 namespace device {
14 class GeolocationDelegate;
15 struct Geoposition;
16
17 // This is the main API to the geolocation subsystem. The application will hold
18 // a single instance of this class and can register multiple clients to be
19 // notified of location changes:
20 // * Callbacks are registered by AddLocationUpdateCallback() and will keep
21 // receiving updates until the returned subscription object is destructed.
22 // The application must instantiate the GeolocationProvider on the UI thread and
23 // must communicate with it on the same thread.
24 // The underlying location arbitrator will only be enabled whilst there is at
25 // least one registered observer or pending callback (and only after
26 // UserDidOptIntoLocationServices). The arbitrator and the location providers it
27 // uses run on a separate Geolocation thread.
28 class GeolocationProvider {
29 public:
30 DEVICE_GEOLOCATION_EXPORT static GeolocationProvider* GetInstance();
31
32 // Optional: provide a Delegate to override typical services.
33 DEVICE_GEOLOCATION_EXPORT static void SetGeolocationDelegate(
34 GeolocationDelegate* delegate);
35
36 typedef base::Callback<void(const Geoposition&)> LocationUpdateCallback;
37 typedef base::CallbackList<void(const Geoposition&)>::Subscription
38 Subscription;
39
40 // |enable_high_accuracy| is used as a 'hint' for the provider preferences for
41 // this particular observer, however the observer could receive updates for
42 // best available locations from any active provider whilst it is registered.
43 virtual std::unique_ptr<Subscription> AddLocationUpdateCallback(
44 const LocationUpdateCallback& callback,
45 bool enable_high_accuracy) = 0;
46
47 // Calling this method indicates the user has opted into using location
48 // services, including sending network requests to [Google servers to] resolve
49 // the user's location. Use this method carefully, in line with the rules in
50 // go/chrome-privacy-doc.
51 virtual void UserDidOptIntoLocationServices() = 0;
52
53 // Overrides the current location for testing.
54 //
55 // Overrides the location for automation/testing. Suppresses any further
56 // updates from the actual providers and sends an update with the overridden
57 // position to all registered clients.
58 //
59 // Do not use this function in unit tests. The function instantiates the
60 // singleton geolocation stack in the background and manipulates it to report
61 // a fake location. Neither step can be undone, breaking unit test isolation
62 // (crbug.com/125931).
63 virtual void OverrideLocationForTesting(const Geoposition& position) = 0;
64
65 protected:
66 virtual~GeolocationProvider() {}
67 };
68
69 } // namespace device
70
71 #endif // DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_
OLDNEW
« no previous file with comments | « device/geolocation/geolocation_export.h ('k') | device/geolocation/geolocation_provider_impl.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698