sync : [ACR-1070] Fused Location

[platform/core/api/location-manager.git] / include / locations.h

diff --git a/include/locations.h b/include/locations.h
index a619fd1..5a121be 100755 (executable)
--- a/include/locations.h
+++ b/include/locations.h
@@ -63,6 +63,7 @@ typedef enum {
        LOCATIONS_METHOD_GPS, /**< This method uses Global Positioning System */
        LOCATIONS_METHOD_WPS, /**< This method uses WiFi Positioning System */
        LOCATIONS_METHOD_PASSIVE, /**< This method can be used to passively receive location updates without power consumption (Since 3.0)*/
+       LOCATIONS_METHOD_FUSED, /**< This method uses Fused location (Since 4.0) */
 } location_method_e;
 
 
@@ -102,6 +103,14 @@ typedef enum {
        LOCATIONS_ACCESS_STATE_ALLOWED, /**< Access authorized */
 } location_accessibility_state_e;
 
+/**
+ * @brief Enumeration for the fused location service.
+ * @since_tizen 4.0
+ */
+typedef enum {
+       LOCATIONS_FUSED_HIGH_ACCURACY = 0,   /**< High accuracy */
+       LOCATIONS_FUSED_BALANCED_POWER,   /**< Balanced power */
+} location_fused_mode_e;
 
 /**
  * @brief The location manager handle.
@@ -1177,6 +1186,21 @@ int location_manager_set_mock_location(location_manager_h manager, const double
  */
 int location_manager_clear_mock_location(location_manager_h manager);
 
+/**
+ * @brief      Changes behavior of the location source selection in the fused location method.
+ * @since_tizen 4.0
+ * @param[in] manager          The location manager handle
+ * @param[in] mode                     The fused mode.
+ * @return @c 0 on success, otherwise a negative error value
+ * @retval #LOCATIONS_ERROR_NONE                                       Successful
+ * @retval #LOCATIONS_ERROR_INVALID_PARAMETER          Invalid parameter
+ * @retval #LOCATIONS_ERROR_INCORRECT_METHOD           Incorrect method
+ * @retval #LOCATIONS_ERROR_SERVICE_NOT_AVAILABLE      The service is not available
+ * @retval #LOCATIONS_ERROR_NOT_SUPPORTED                      Not supported
+ * @see location_manager_create()
+ */
+int location_manager_set_fused_mode(location_manager_h manager, location_fused_mode_e mode);
+
 
 /**
  * @}