| OLD | NEW |
| 1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ | 5 #ifndef DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ |
| 6 #define DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ | 6 #define DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ |
| 7 | 7 |
| 8 #include "base/callback.h" | 8 #include "base/callback.h" |
| 9 #include "base/compiler_specific.h" | 9 #include "base/compiler_specific.h" |
| 10 #include "device/geolocation/geoposition.h" | 10 #include "device/geolocation/geoposition.h" |
| 11 | 11 |
| 12 namespace device { | 12 namespace device { |
| 13 | 13 |
| 14 class LocationProvider; | 14 class LocationProvider; |
| 15 | 15 |
| 16 // The interface for providing location information. | 16 // The interface for providing location information. |
| 17 class LocationProvider { | 17 class DEVICE_GEOLOCATION_EXPORT LocationProvider { |
| 18 public: | 18 public: |
| 19 virtual ~LocationProvider() {} | 19 virtual ~LocationProvider() {} |
| 20 | 20 |
| 21 typedef base::Callback<void(const LocationProvider*, const Geoposition&)> | 21 typedef base::Callback<void(const LocationProvider*, const Geoposition&)> |
| 22 LocationProviderUpdateCallback; | 22 LocationProviderUpdateCallback; |
| 23 | 23 |
| 24 // This callback will be used to notify when a new Geoposition becomes | 24 // This callback will be used to notify when a new Geoposition becomes |
| 25 // available. | 25 // available. |
| 26 virtual void SetUpdateCallback( | 26 virtual void SetUpdateCallback( |
| 27 const LocationProviderUpdateCallback& callback) = 0; | 27 const LocationProviderUpdateCallback& callback) = 0; |
| 28 | 28 |
| 29 // StartProvider maybe called multiple times, e.g. to alter the | 29 // StartProvider maybe called multiple times, e.g. to alter the |
| 30 // |high_accuracy| setting. Returns false if a fatal error was encountered | 30 // |high_accuracy| setting. Returns false if a fatal error was encountered |
| 31 // which prevented the provider from starting. | 31 // which prevented the provider from starting. |
| 32 virtual bool StartProvider(bool high_accuracy) = 0; | 32 virtual bool StartProvider(bool high_accuracy) = 0; |
| 33 | 33 |
| 34 // Stops the provider from sending more requests. | 34 // Stops the provider from sending more requests. |
| 35 // Important: a LocationProvider may be instantiated and StartProvider() may | 35 // Important: a LocationProvider may be instantiated and StartProvider() may |
| 36 // be called before the user has granted permission via OnPermissionGranted(). | 36 // be called before the user has granted permission via OnPermissionGranted(). |
| 37 // This is to allow underlying providers to warm up, load their internal | 37 // This is to allow underlying providers to warm up, load their internal |
| 38 // libraries, etc. No |LocationProviderUpdateCallback| can be run and no | 38 // libraries, etc. No |LocationProviderUpdateCallback| can be run and no |
| 39 // network requests can be done until OnPermissionGranted() has been called. | 39 // network requests can be done until OnPermissionGranted() has been called. |
| 40 virtual void StopProvider() = 0; | 40 virtual void StopProvider() = 0; |
| 41 | 41 |
| 42 // Gets the current best position estimate. | 42 // Gets the current best position estimate. |
| 43 virtual void GetPosition(Geoposition* position) = 0; | 43 virtual const Geoposition& GetPosition() = 0; |
| 44 | |
| 45 // Provides a hint to the provider that new location data is needed as soon | |
| 46 // as possible. | |
| 47 virtual void RequestRefresh() = 0; | |
| 48 | 44 |
| 49 // Called everytime permission is granted to a page for using geolocation. | 45 // Called everytime permission is granted to a page for using geolocation. |
| 50 // This may either be through explicit user action (e.g. responding to the | 46 // This may either be through explicit user action (e.g. responding to the |
| 51 // infobar prompt) or inferred from a persisted site permission. | 47 // infobar prompt) or inferred from a persisted site permission. |
| 52 // Note: See |StartProvider()| for more information. | 48 // Note: See |StartProvider()| for more information. |
| 53 virtual void OnPermissionGranted() = 0; | 49 virtual void OnPermissionGranted() = 0; |
| 54 }; | 50 }; |
| 55 | 51 |
| 56 } // namespace device | 52 } // namespace device |
| 57 | 53 |
| 58 #endif // DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ | 54 #endif // DEVICE_GEOLOCATION_LOCATION_PROVIDER_H_ |
| OLD | NEW |