| // Copyright (c) 2012 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 DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_ |
| #define DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_ |
| |
| #include <memory> |
| |
| #include "base/callback_list.h" |
| #include "device/geolocation/geolocation_export.h" |
| #include "device/geolocation/public/interfaces/geoposition.mojom.h" |
| #include "net/url_request/url_request_context_getter.h" |
| |
| namespace device { |
| |
| // This is the main API to the geolocation subsystem. The application will hold |
| // a single instance of this class and can register multiple clients to be |
| // notified of location changes: |
| // * Callbacks are registered by AddLocationUpdateCallback() and will keep |
| // receiving updates until the returned subscription object is destructed. |
| // The application must instantiate the GeolocationProvider on the UI thread and |
| // must communicate with it on the same thread. |
| // The underlying location arbitrator will only be enabled whilst there is at |
| // least one registered observer or pending callback (and only after |
| // mojom::UserDidOptIntoLocationServices() which is implemented by |
| // GeolocationProviderImpl). The arbitrator and the location providers it uses |
| // run on a separate Geolocation thread. |
| // TODO(ke.he@intel.com): With the proceeding of the servicification of |
| // geolocation, the geolocation core will be moved into //services/device and as |
| // a internal part of Device Service. This geolocation_provider.h will also be |
| // removed. |
| class GeolocationProvider { |
| public: |
| DEVICE_GEOLOCATION_EXPORT static GeolocationProvider* GetInstance(); |
| |
| // Callback type for a function that asynchronously produces a |
| // URLRequestContextGetter. |
| using RequestContextProducer = base::RepeatingCallback<void( |
| base::OnceCallback<void(scoped_refptr<net::URLRequestContextGetter>)>)>; |
| |
| // Optional: Provide a callback to produce a request context for network |
| // geolocation requests. |
| // Call before using GetInstance(). |
| DEVICE_GEOLOCATION_EXPORT static void SetRequestContextProducer( |
| RequestContextProducer request_context_producer); |
| |
| // Optional: Provide a Google API key for network geolocation requests. |
| // Call before using Init() on the singleton GetInstance(). |
| DEVICE_GEOLOCATION_EXPORT static void SetApiKey(const std::string& api_key); |
| |
| typedef base::Callback<void(const mojom::Geoposition&)> |
| LocationUpdateCallback; |
| typedef base::CallbackList<void(const mojom::Geoposition&)>::Subscription |
| Subscription; |
| |
| // |enable_high_accuracy| is used as a 'hint' for the provider preferences for |
| // this particular observer, however the observer could receive updates for |
| // best available locations from any active provider whilst it is registered. |
| virtual std::unique_ptr<Subscription> AddLocationUpdateCallback( |
| const LocationUpdateCallback& callback, |
| bool enable_high_accuracy) = 0; |
| |
| virtual bool HighAccuracyLocationInUse() = 0; |
| |
| // Overrides the current location for testing. |
| // |
| // Overrides the location for automation/testing. Suppresses any further |
| // updates from the actual providers and sends an update with the overridden |
| // position to all registered clients. |
| // |
| // Do not use this function in unit tests. The function instantiates the |
| // singleton geolocation stack in the background and manipulates it to report |
| // a fake location. Neither step can be undone, breaking unit test isolation |
| // (crbug.com/125931). |
| virtual void OverrideLocationForTesting( |
| const mojom::Geoposition& position) = 0; |
| |
| protected: |
| virtual ~GeolocationProvider() {} |
| }; |
| |
| } // namespace device |
| |
| #endif // DEVICE_GEOLOCATION_GEOLOCATION_PROVIDER_H_ |