* @deprecated Deprecated since 8.0.
* @brief The address handle.
* @details The address handle can be obtained via calling of maps_address_create().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef void *maps_address_h;
* @deprecated Deprecated since 8.0.
* @brief The address list handle.
* @details The address list handle can be obtained via calling of maps_address_list_create().
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef void *maps_address_list_h;
* @deprecated Deprecated since 8.0.
* @brief Creates a new address handle.
* @details This function creates a new address handle and allocates all needed resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a address must be released using maps_address_destroy().\n
* @a address may be cloned using maps_address_clone().
* @param[out] address The address handle
* @deprecated Deprecated since 8.0.
* @brief Destroys the address handle and releases all its resources.
* @details This function destroys the address handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @brief Clones the address handle.
* @details This function clones the address handle @a origin and all its resources.\n
* Address handle @a origin may be created using maps_address_create().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_address_destroy().
* @param[in] origin The original address handle
* @param[out] cloned A cloned address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the building number of the address handle.
* @details This function gets the building number of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a building_number must be released using free().
* @param[in] address The address handle
* @param[out] building_number The building number of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the street name of the address handle.
* @details This function gets the street name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a street must be released using free().
* @param[in] address The address handle
* @param[out] street The street name of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the district name of the address handle.
* @details This function gets the district name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a district must be released using free().
* @param[in] address The address handle
* @param[out] district The district name of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the city name of the address handle.
* @details This function gets the city name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a city must be released using free().
* @param[in] address The address handle
* @param[out] city The city name of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the state name of the address handle.
* @details This function gets the state name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a state must be released using free().
* @param[in] address The address handle
* @param[out] state The state name of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the country name of the address handle.
* @details This function gets the country name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a country must be released using free().
* @param[in] address The address handle
* @param[out] country The country name of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the country code of the address handle.
* @details This function gets the country code of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a country_code must be released using free().
* @param[in] address The address handle
* @param[out] country_code The country code of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the county of the address handle.
* @details This function gets the county of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a county must be released using free().
* @param[in] address The address handle
* @param[out] county The county of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the postal code of the address handle.
* @details This function gets the postal code of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a postal_code must be released using free().
* @param[in] address The address handle
* @param[out] postal_code The postal code of the address handle
* @deprecated Deprecated since 8.0.
* @brief Gets the free text of the address handle.
* @details This function gets the free text of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a freetext must be released using free().
* @param[in] address The address handle
* @param[out] freetext The free text of the address handle
* @deprecated Deprecated since 8.0.
* @brief Sets the building number of the address handle.
* @details This function sets the building number of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] building_number The building number to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the street name of the address handle.
* @details This function sets the street name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] street The street name to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the district name of the address handle.
* @details This function sets the district name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] district The district name to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the city name of the address handle.
* @details This function sets the city name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] city The city name to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the state name of the address handle.
* @details This function sets the state name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] state The state name to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the country name of the address handle.
* @details This function sets the country name of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] country The country name to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the country code of the address handle.
* @details This function sets the country code of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] country_code The country code to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the county of the address handle.
* @details This function sets the county of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] county The county to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the postal code of the address handle.
* @details This function sets the postal code of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] postal_code The postal code to be set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the free text of the address handle.
* @details This function sets the free text of the address handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] address The address handle
* @param[in] freetext The free text to be set
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Creates an address list having a set of addresses.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[out] address_list The address list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @deprecated Deprecated since 8.0.
* @brief Appends an address to an address list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks Don't release @a address before removed from the list using maps_address_list_remove().
* @param[in] address_list The address list handle
* @param[in] address The address handle
/**
* @deprecated Deprecated since 8.0.
* @brief Removes an address from an address list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a address is just excepted from the list.\n
* It must be released using maps_address_destroy().
* @param[in] address_list The address list handle
/**
* @deprecated Deprecated since 8.0.
* @brief Gets the number of elements in an address list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] address_list The address list handle
* @param[out] length The number of elements in the address list
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Called iteratively to get address information.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] index The index of iteration
* @param[in] address The address handle
* @param[in] user_data The user data passed from the foreach function
/**
* @deprecated Deprecated since 8.0.
* @brief Retrieves all addresses by invoking a specific callback for each address of address list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] address_list The address list handle
* @param[in] callback The iteration callback
* @param[in] user_data The user data to be passed to the callback function
/**
* @deprecated Deprecated since 8.0.
* @brief Frees all of the memory used by an address list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] address_list The address list handle
* @return @c 0 on success,
* otherwise a negative error value
* @details The Geographical Area handle can be obtained via call of maps_area_create_rectangle() or maps_area_create_circle().\n
* To release the handle use maps_area_destroy().\n
* To clone the handle use maps_area_clone().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see maps_area_create_rectangle()
* @see maps_area_create_circle()
* @see maps_area_destroy()
* @deprecated Deprecated since 8.0.
* @brief Enumeration for supported types of the Geographical Area.
* @details This enumeration represents allowed geographical type of Geographical Area: rectangular and circular.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum {
MAPS_AREA_NONE = 0, /**< Undefined geographical area type. */
* @deprecated Deprecated since 8.0.
* @brief Structure of the rectangular Geographical Area.
* @details This structure represents a rectangular Geographical Area, specified with left top and right bottom coordinates.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks Do not use #maps_area_rectangle_s directly if you are an application developer.
*/
typedef struct _maps_area_rectangle_s {
* @deprecated Deprecated since 8.0.
* @brief Structure of the circular Geographical Area, specified with a center coordinates and a radius.
* @details This structure represents a circular Geographical Area.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks Do not use #maps_area_circle_s directly if you are an application developer.
*/
typedef struct _maps_area_circle_s {
* @deprecated Deprecated since 8.0.
* @brief Structure of the Geographical Area.
* @details This structure represents a Geographical Area, specified with a type, circular or rectangular, and appropriate coordinates and radius.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks Do not use #maps_area_s directly if you are an application developer.
* Using #maps_area_h is recommended.
*/
* @deprecated Deprecated since 8.0.
* @brief Creates a rectangular type of new Geographical Area with a specified information.
* @details This function creates a rectangular type of new #maps_area_h with a specified left top and right bottom coordinates.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a area must be released using maps_area_destroy().\n
* @a area may be cloned using maps_area_clone().\n
* @a top_left and @a bottom_right must be released using maps_coordinates_destroy().
* @deprecated Deprecated since 8.0.
* @brief Creates a circular type of new Geographical Area with a specified information.
* @details This function creates a circular type of new #maps_area_h Geographical Area with a specified center coordinates and a radius.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a area must be released using maps_area_destroy().\n
* @a center must be released using maps_coordinates_destroy().\n
* The @a radius is specified in units, listed in #maps_distance_unit_e.\n
* @deprecated Deprecated since 8.0.
* @brief Destroys the Geographical Area and releases all its resources.
* @details This function destroys the Geographical Area #maps_area_h and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] area The area #maps_area_h
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the Geographical Area.
* @details This function makes a clone of the @a origin Geographical Area of type #maps_area_h.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_area_destroy().
* @param[in] origin The area #maps_area_h to be copied
* @param[out] cloned The cloned area #maps_area_h handle
* @deprecated Deprecated since 8.0.
* @brief Handle of the Geographical Coordinates.
* @details The Geographical Coordinates handle can be obtained via call of maps_coordinates_create().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @remarks To release the handle use maps_coordinates_destroy().\n
* To clone the handle use maps_coordinates_clone().
*/
* @details This structure represents a Geographical Coordinates, specified with a @a latitude and @a longitude values.\n
* The @a latitude must be in range of [-90.0, 90.0].\n
* The @a longitude must be in range of [-180.0, 180.0].
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @remarks #maps_coordinates_h is a void pointer to the #maps_coordinates_h.
* @remarks Do not use #maps_coordinates_s directly if you are an application developer.
* Using #maps_coordinates_h is recommended.
* @deprecated Deprecated since 8.0.
* @brief The coordinates list handle.
* @details The coordinates list handle can be obtained via calling of maps_coordinates_list_create().
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef void *maps_coordinates_list_h;
* @brief Creates a new instance of Geographical Coordinates and initiates a handle with it.
* @details This function creates @a coordinates, a new instance of Geographical Coordinates of type #maps_coordinates_h with a specified @a latitude and @a longitude.\n
* New handle is assigned with this instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @remarks @a coordinates must be released using maps_coordinates_destroy().\n
* @a coordinates may be cloned using maps_coordinates_clone().
* @param[in] latitude The latitude [-90.0 ~ 90.0] (degrees)
* @deprecated Deprecated since 8.0.
* @brief Destroys the Geographical Coordinates and releases all its resources.
* @details This function destroys the Geographical Coordinates #maps_coordinates_h and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @param[in] coordinates The coordinate handle to destroy
* @return @c 0 on coordinates,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the Geographical Coordinates.
* @details This function makes a clone of the @a origin Geographical Coordinates of type #maps_coordinates_h.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @remarks @a cloned must be released using maps_coordinates_destroy().
* @param[in] origin The original coordinate handle
* @param[out] cloned A cloned coordinate handle
* @deprecated Deprecated since 8.0.
* @brief Gets the latitude of the coordinates.
* @details This function gets the @a latitude value of the coordinates handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @param[in] coordinates The coordinate handle
* @param[out] latitude The latitude of the coordinate handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the longitude of the coordinates.
* @details This function gets the @a longitude value of the coordinates handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @param[in] coordinates The coordinate handle
* @param[out] longitude The longitude of the coordinate handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the latitude and longitude of the coordinates.
* @details This function gets the @a longitude and @a longitude value of the coordinates handle.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates The coordinate handle
* @param[out] latitude The latitude of the coordinate handle
* @param[out] longitude The longitude of the coordinate handle
* @deprecated Deprecated since 8.0.
* @brief Sets the latitude of the coordinates.
* @details This function sets the @a latitude value of the coordinates handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @param[in] coordinates The coordinate handle
* @param[in] latitude The latitude of the coordinate handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the longitude of the coordinates.
* @details This function sets the @a longitude value of the coordinates handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tize 2.4
* @param[in] coordinates The coordinate handle
* @param[out] longitude The longitude of the coordinate handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the latitude and longitude of the coordinates.
* @details This function sets the @a latitude and @a latitude value of the coordinates handle.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates The coordinates handle
* @param[in] latitude The latitude [-90.0 ~ 90.0] (degrees)
* @param[in] longitude The longitude [-180.0 ~ 180.0] (degrees)
/**
* @deprecated Deprecated since 8.0.
* @brief Creates a coordinates list having a set of coordinates.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[out] coordinates_list The coordinates list handle
* @return @c 0 on success,
* otherwise a negative error value
/**
* @deprecated Deprecated since 8.0.
* @brief Frees all of the memory used by a coordinates list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates_list The coordinates list handle
* @retval #MAPS_ERROR_NONE Successful
* @retval #MAPS_ERROR_INVALID_PARAMETER Invalid parameter
/**
* @deprecated Deprecated since 8.0.
* @brief Appends a coordinates to a coordinates list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates_list The coordinates list handle
* @param[in] coordinates The coordinates handle
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Removes a coordinates from a coordinates list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates_list The coordinates list handle
* @param[in] coordinates The coordinates handle
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Gets the number of elements in a coordinates list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates_list The coordinates list handle
* @param[out] length The number of elements in the coordinates list
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Called iteratively to get a coordinates information.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] index The index of iteration
* @param[in] coordinates The handle of coordinates
* @param[in] user_data The user data passed from the foreach function
/**
* @deprecated Deprecated since 8.0.
* @brief Retrieves all coordinates by invoking a specific callback for each coordinates of coordinates list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] coordinates_list The coordinates list handle
* @param[in] callback The iteration callback
* @param[in] user_data The user data to be passed to the callback function
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for error codes for Maps Service and Plug-ins.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum _maps_error_e {
MAPS_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
TIZEN_ERROR_UNKNOWN, /**< Unknown error */
MAPS_ERROR_USER_NOT_CONSENTED =
- TIZEN_ERROR_USER_NOT_CONSENTED, /**< Not Consented (Since @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif) */
+ TIZEN_ERROR_USER_NOT_CONSENTED, /**< Not Consented (Since 3.0) */
MAPS_ERROR_SERVICE_NOT_AVAILABLE =
TIZEN_ERROR_MAPS_SERVICE | 0x01, /**< Service unavailable */
* @deprecated Deprecated since 8.0.
* @brief The Place handle.
* @details The handle of Place instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_destroy().\n
* To clone the handle use maps_place_clone().
* @see maps_place_destroy()
* @deprecated Deprecated since 8.0.
* @brief The Place list handle.
* @details The handle of Place list instance.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @see maps_place_list_foreach()
* @see maps_place_list_destroy()
*/
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Properties.
* @details This callback is invoked while iterating through the list of Place Properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a key and @a value must be released using free() and corresponding release method for property value correspondingly.
* @param[in] index The current index of property
* @param[in] total The total amount of properties
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Categories.
* @details This callback is invoked while iterating through the list of Place Categories.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a category is valid only in this function and must be released using maps_place_category_destroy().\n
* To use @a category outside this function, clone it with maps_place_category_clone().
* @param[in] index The current index of category
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Attributes.
* @details This callback is invoked while iterating through the list of Place Attributes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a attribute is valid only in this function and must be released using maps_place_attribute_destroy().\n
* To use @a attribute outside this function, clone it with maps_place_attribute_clone().
* @param[in] index The current index of attribute
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Contacts.
* @details This callback is invoked while iterating through the list of Place Contacts.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a contact is valid only in this function and must be released using maps_place_contact_destroy().\n
* To use @a contact outside this function, clone it with maps_place_contact_clone().
* @param[in] index The current index of contact
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Editorial.
* @details This callback is invoked while iterating through the list of Place Editorials.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a editorial is valid only in this function and must be released using maps_place_editorial_destroy().\n
* To use @a editorial outside this function, clone it with maps_place_editorial_clone().
* @param[in] index The current index of editorial
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Image.
* @details This callback is invoked while iterating through the list of Place Images.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a image is valid only in this function and must be released using maps_place_image_destroy().\n
* To use @a image outside this function, clone it with maps_place_image_clone().
* @param[in] index The current index of image
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Review.
* @details This callback is invoked while iterating through the list of Place Reviews.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a review is valid only in this function and must be released using maps_place_review_destroy().\n
* To use @a review outside this function, clone it with maps_place_review_clone().
* @param[in] index The current index of review
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place.
* @details This callback is invoked while iterating through the list of Place.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] index The current index of review
* @param[in] place The place handle
* @param[in] user_data The user data passed from the maps_place_list_foreach()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place handle and releases all its resources.
* @details This function destroys the place handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] place The place handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place handle.
* @details This function clones the place handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_destroy().
* @param[in] origin The original place handle
* @param[out] cloned A cloned place handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place ID.
* @details This function gets the place ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] place The place handle
* @param[out] id The place ID
* @deprecated Deprecated since 8.0.
* @brief Gets the place name.
* @details This function gets the place name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a name must be released using free().
* @param[in] place The place handle
* @param[out] name The place name
* @deprecated Deprecated since 8.0.
* @brief Gets the place view URI.
* @details This function gets the place view URI.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a uri must be released using free().
* @param[in] place The place handle
* @param[out] uri The place view URI
* @deprecated Deprecated since 8.0.
* @brief Gets the place location.
* @details This function gets the place location.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a location must be released using maps_coordinates_destroy().
* @param[in] place The place handle
* @param[out] location The place location
* @deprecated Deprecated since 8.0.
* @brief Gets the place distance from the center of the location.
* @details This function gets the place distance from the center of the location.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] place The place handle
* @param[out] distance The place distance in meters
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the place address.
* @details This function gets the place address.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a address must be released using maps_address_destroy().
* @param[in] place The place handle
* @param[out] address The place address
* @deprecated Deprecated since 8.0.
* @brief Gets the place rating.
* @details This function gets the place rating.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a rating must be released using maps_place_rating_destroy().
* @param[in] place The place handle
* @param[out] rating The place rating handle
* @deprecated Deprecated since 8.0.
* @brief Retrieves all properties.
* @details This function retrieves all place properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The properties will be delivered via maps_place_properties_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all categories
* @details This function retrieves all place categories.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The categories will be delivered via maps_place_categories_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all attributes.
* @details This function retrieves all place attributes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The attributes will be delivered via maps_place_attributes_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all contacts.
* @details This function retrieves all place contacts.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The contacts will be delivered via maps_place_contacts_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all editorials.
* @details This function retrieves all place editorials.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The editorials will be delivered via maps_place_editorials_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all images.
* @details This function retrieves all place images.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The images will be delivered via maps_place_images_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all reviews.
* @details This function retrieves all place reviews.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The reviews will be delivered via maps_place_reviews_cb().
* @param[in] place The place handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Gets the place supplier link.
* @details This function gets the place supplier link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a supplier must be released using maps_place_link_object_destroy().
* @param[in] place The place handle
* @param[out] supplier The place supplier link
* @deprecated Deprecated since 8.0.
* @brief Gets the place related link.
* @details This function gets the place related link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a related must be released using maps_place_link_object_destroy().
* @param[in] place The place handle
* @param[out] related The place related link
* @deprecated Deprecated since 8.0.
* @brief Retrieves all places.
* @details This function retrieves all places.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The places will be delivered via maps_place_cb().\n
* @a place_list must be released using maps_place_list_destroy().
* @param[in] place_list The place list handle
/**
* @deprecated Deprecated since 8.0.
* @brief Frees all of the memory used by a place list.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] place_list The place list handle
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief The Place Attribute handle.
* @details The handle of Place Attribute instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_attribute_destroy().\n
* To clone the handle use maps_place_attribute_clone().
* @see maps_place_attribute_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place attribute handle and releases all its resources.
* @details This function destroys the place attribute handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] attribute The place attribute handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place attribute handle.
* @details This function clones the place attribute handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_attribute_destroy().
* @param[in] origin The original place attribute handle
* @param[out] cloned A cloned place attribute handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place attribute ID.
* @details This function gets the place attribute ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] attribute The handle to place attribute
* @param[out] id The place attribute ID
* @deprecated Deprecated since 8.0.
* @brief Gets the place attribute label.
* @details This function gets the place attribute label.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a label must be released using free().
* @param[in] attribute The handle to place attribute
* @param[out] label The place attribute label
* @deprecated Deprecated since 8.0.
* @brief Gets the place attribute text.
* @details This function gets the place attribute text.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a text must be released using free().
* @param[in] attribute The handle to place attribute
* @param[out] text The place attribute text
* @deprecated Deprecated since 8.0.
* @brief The Place Category handle.
* @details The handle of Place Category instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_category_destroy().\n
* To clone the handle use maps_place_category_clone().
* @see maps_place_category_destroy()
* @deprecated Deprecated since 8.0.
* @brief Creates a new place category handle.
* @details This function creates a new place category handle and allocates all needed resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a category must be released using maps_place_category_destroy().\n
* @a category may be cloned using maps_place_category_clone().
* @param[out] category A handle of a new place category on success
* @deprecated Deprecated since 8.0.
* @brief Clones the place category handle.
* @details This function clones the place category handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_category_destroy().
* @param[in] origin The original place category handle
* @param[out] cloned A cloned place category handle
* @deprecated Deprecated since 8.0.
* @brief Destroys the place category handle and releases all its resources.
* @details This function destroys the place category handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] category The place category handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Gets the place category ID.
* @details This function gets the place category ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] category The handle of place category
* @param[out] id The place category ID
* @deprecated Deprecated since 8.0.
* @brief Gets the place category name.
* @details This function gets the place category name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a name must be released using free().
* @param[in] category The handle of place category
* @param[out] name The place category name
* @deprecated Deprecated since 8.0.
* @brief Gets the place category URL.
* @details This function gets the place category URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a url must be released using free().
* @param[in] category The handle of place category
* @param[out] url The place category URL
* @deprecated Deprecated since 8.0.
* @brief Sets the place category ID.
* @details This function sets the place category ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] category The handle of place category
* @param[in] id The place category ID
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the place category name.
* @details This function sets the place category name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] category The handle of place category
* @param[in] name The place category name
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the place category URL.
* @details This function sets the place category URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] category The handle of place category
* @param[in] url The place category URL
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief The Place Contact handle.
* @details The handle of Place Contact instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_contact_destroy().\n
* To clone the handle use maps_place_contact_clone().
* @see maps_place_contact_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place contact handle and releases all its resources.
* @details This function destroys the place contact handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] contact The place contact handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place contact handle.
* @details This function clones the place contact handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_contact_destroy().
* @param[in] origin The original place contact handle
* @param[out] cloned A cloned place contact handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place contact label.
* @details This function gets the place contact label.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a label must be released using free().
* @param[in] contact The handle to place contact
* @param[out] label The place contact label
* @deprecated Deprecated since 8.0.
* @brief Gets the place contact type.
* @details This function gets the place contact type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a type must be released using free().
* @param[in] contact The handle to place contact
* @param[out] type The place contact type
* @deprecated Deprecated since 8.0.
* @brief Gets the place contact value.
* @details This function gets the place contact value.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a value must be released using free().
* @param[in] contact The handle to place contact
* @param[out] value The place contact value
* @deprecated Deprecated since 8.0.
* @brief The Place Editorial handle.
* @details The handle of Place Editorial instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_editorial_destroy().\n
* To clone the handle use maps_place_editorial_clone().
* @see maps_place_editorial_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place editorial handle and releases all its resources.
* @details This function destroys the place editorial handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] editorial The place editorial handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place editorial handle.
* @details This function clones the place editorial handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_editorial_destroy().
* @param[in] origin The original place editorial handle
* @param[out] cloned A cloned place editorial handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place editorial description.
* @details This function gets the place editorial description.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a description must be released using free().
* @param[in] editorial The handle of place editorial
* @param[out] description The place editorial description
* @deprecated Deprecated since 8.0.
* @brief Gets the place editorial language.
* @details This function gets the place editorial language.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a language must be released using free().
* @param[in] editorial The handle of place editorial
* @param[out] language The place editorial language
* @deprecated Deprecated since 8.0.
* @brief Gets the place editorial media.
* @details This function gets the place editorial media.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a media must be released using maps_place_media_destroy().
* @param[in] editorial The handle of place editorial
* @param[out] media The place editorial media
* @deprecated Deprecated since 8.0.
* @brief The Place Filter handle.
* @details The handle of Place Filter instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_filter_destroy().\n
* To clone the handle use maps_place_filter_clone().
* @see maps_place_filter_destroy()
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Place Filter Properties.
* @details This callback is invoked while iterating through the list of Place Filter Properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a key and @a value must be released using free() and corresponding release method for property value correspondingly.
* @param[in] index The current index of property
* @param[in] total The total amount of properties
* @deprecated Deprecated since 8.0.
* @brief Creates a new Place Filter handle.
* @details This function creates a new place filter handle and allocates all needed resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a filter must be released using maps_place_filter_destroy().\n
* @a filter may be cloned using maps_place_filter_clone().
* @param[out] filter A handle of a new place filter on success
* @deprecated Deprecated since 8.0.
* @brief Destroys the place filter handle and releases all its resources.
* @details This function destroys the place filter handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The place filter handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @brief Clones the place filter handle.
* @details This function clones the place filter handle @a origin and all its resources.\n
* Place filter handle @a origin may be created using maps_place_filter_create().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_filter_destroy().
* @param[in] origin The place filter handle to be cloned
* @param[out] cloned A handle of a newly cloned place filter on success
* @deprecated Deprecated since 8.0.
* @brief Gets the value of the specified key in the place filter.
* @details This function gets the value of the specified key in the place filter.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a value must be released using free().
* @param[in] filter The handle of the place filter
* @param[in] key The key of filter
* @deprecated Deprecated since 8.0.
* @brief Gets the value of keyword.
* @details This function gets the value of keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a keyword must be released using free().
* @param[in] filter The handle of the place filter
* @param[out] keyword The key of filter
* @deprecated Deprecated since 8.0.
* @brief Gets the place name.
* @details This function gets the place name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a place_name must be released using free().
* @param[in] filter The handle of the place filter
* @param[out] place_name The place name
* @brief Gets the category.
* @details This function gets the category.\n
* For allowed values of keys, see the macros above.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a category must be released using maps_place_category_destroy().
* @param[in] filter The handle of the place filter
* @param[out] category The category
* @deprecated Deprecated since 8.0.
* @brief Retrieves all filter properties.
* @details This function retrieves all place filter properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The handle of the place filter
* @param[in] callback The callback function to invoke
* @param[in] user_data The user data to be passed to the callback function
* @deprecated Deprecated since 8.0.
* @brief Gets the place address.
* @details This function gets the place address.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a place_address must be released using free().
* @param[in] filter The handle of the place filter
* @param[out] place_address The place address
* @deprecated Deprecated since 8.0.
* @brief Sets the filter value.
* @details This function sets the filter value in an assignment with a specified string key.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The handle of the place filter
* @param[in] key The key of filter
* @param[in] value The filter value to set, could be NULL if want remove value
* @deprecated Deprecated since 8.0.
* @brief Sets the keyword.
* @details This function sets the keyword.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The handle of the place filter
* @param[in] keyword The keyword
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the place name.
* @details This function sets the place name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The handle of the place filter
* @param[in] place_name The place name
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the category.
* @details This function sets the place name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] filter The handle of the place filter
* @param[in] category The category
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the place address.
* @details This function sets the place address.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] filter The handle of the place filter
* @param[in] place_address The place address
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief The Place Image handle.
* @details The handle of Place Image instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_image_destroy().\n
* To clone the handle use maps_place_image_clone().
* @see maps_place_image_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place image handle and releases all its resources.
* @details This function destroys the place image handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] image The place image handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place image handle.
* @details This function clones the place image handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_image_destroy().
* @param[in] origin The original place image handle
* @param[out] cloned A cloned place image handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place image ID.
* @details This function gets the place image ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] image The handle of place image
* @param[out] id The place image ID
* @deprecated Deprecated since 8.0.
* @brief Gets the place image URL.
* @details This function gets the place image URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a url must be released using free().
* @param[in] image The handle of place image
* @param[out] url The place image url
* @deprecated Deprecated since 8.0.
* @brief Gets the place image width.
* @details This function gets the place image width.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] image The handle of place image
* @param[out] width The place image width
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the place image height.
* @details This function gets the place image height.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] image The handle of place image
* @param[out] height The place image height
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the place image user link.
* @details This function gets the place image user link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a user must be released using maps_place_link_object_destroy().
* @param[in] image The handle of place image
* @param[out] user The place image user link
* @deprecated Deprecated since 8.0.
* @brief Gets the place image media.
* @details This function gets the place image media.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a media must be released using maps_place_media_destroy().
* @param[in] image The handle of place image
* @param[out] media The place image media
* @deprecated Deprecated since 8.0.
* @brief The Place Link Object handle.
* @details The handle of Place Link Object instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_link_object_destroy().\n
* To clone the handle use maps_place_link_object_clone().
* @see maps_place_link_object_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place link object handle and releases all its resources.
* @details This function destroys the place link object handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] link The place link object handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place link object handle.
* @details This function clones the place link object handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_link_object_destroy().
* @param[in] origin The original place link object handle
* @param[out] cloned A cloned place link object handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place link object ID.
* @details This function gets the place link object ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] link The handle of place link object
* @param[out] id The place link object ID
* @deprecated Deprecated since 8.0.
* @brief Gets the place link object name.
* @details This function gets the place link object name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a name must be released using free().
* @param[in] link The handle of place link object
* @param[out] name The place link object name
* @deprecated Deprecated since 8.0.
* @brief Gets the place link object string.
* @details This function gets the place link object string.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a string must be released using free().
* @param[in] link The handle of place link object
* @param[out] string The place link object string
* @deprecated Deprecated since 8.0.
* @brief Gets the place link object type.
* @details This function gets the place link object type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a type must be released using free().
* @param[in] link The handle of place link object
* @param[out] type The place link object type
* @deprecated Deprecated since 8.0.
* @brief The Place Media handle.
* @details The handle of Place Media instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_media_destroy().\n
* To clone the handle use maps_place_media_clone().
* @see maps_place_media_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place media handle and releases all its resources.
* @details This function destroys the place media handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] media The place media handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place media handle.
* @details This function clones the place media handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_media_destroy().
* @param[in] origin The original place media handle
* @param[out] cloned A cloned place media handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place media attribution.
* @details This function gets the place media attribution.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a attribution must be released using free().
* @param[in] media The handle of place media
* @param[out] attribution The place media attribution
* @deprecated Deprecated since 8.0.
* @brief Gets the place media supplier link.
* @details This function gets the place media supplier link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a supplier must be released using maps_place_link_object_destroy().
* @param[in] media The handle of place media
* @param[out] supplier The place media supplier link
* @deprecated Deprecated since 8.0.
* @brief Gets the place media "via" link.
* @details This function gets the place media "via" link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a via must be released using maps_place_link_object_destroy().
* @param[in] media The handle of place media
* @param[out] via The place media via link
* @deprecated Deprecated since 8.0.
* @brief The Place Review handle.
* @details The handle of Place Review instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_review_destroy().\n
* To clone the handle use maps_place_review_clone().
* @see maps_place_review_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place review handle and releases all its resources.
* @details This function destroys the place review handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] review The place review handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place review handle.
* @details This function clones the place review handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_review_destroy().
* @param[in] origin The original place review handle
* @param[out] cloned A cloned place review handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place review date.
* @details This function gets the place review date.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a date must be released using free().
* @param[in] review The handle to place review
* @param[out] date The place review date
* @deprecated Deprecated since 8.0.
* @brief Gets the place review title.
* @details This function gets the place review title.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a title must be released using free().
* @param[in] review The handle to place review
* @param[out] title The place review title
* @deprecated Deprecated since 8.0.
* @brief Gets the place review rating.
* @details This function gets the place review rating.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] review The handle to place review
* @param[out] rating The place review rating
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the place review description.
* @details This function gets the place review description.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a description must be released using free().
* @param[in] review The handle to place review
* @param[out] description The place review description
* @deprecated Deprecated since 8.0.
* @brief Gets the place review language.
* @details This function gets the place review language.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a language must be released using free().
* @param[in] review The handle to place review
* @param[out] language The place review language
* @deprecated Deprecated since 8.0.
* @brief Gets the place review media.
* @details This function gets the place review media.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a media must be released using maps_place_media_destroy().
* @param[in] review The handle to place review
* @param[out] media The place review media
* @deprecated Deprecated since 8.0.
* @brief Gets the place review user link.
* @details This function gets the place review user link.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a user must be released using maps_place_link_object_destroy().
* @param[in] review The handle to place review
* @param[out] user The place review user link
* @deprecated Deprecated since 8.0.
* @brief The Place URL handle.
* @details The handle of Place URL instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_place_url_destroy().\n
* To clone the handle use maps_place_url_clone().
* @see maps_place_url_destroy()
* @deprecated Deprecated since 8.0.
* @brief Destroys the place URL handle and releases all its resources.
* @details This function destroys the place URL handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] url The place URL handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the place URL handle.
* @details This function clones the place URL handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_place_url_destroy().
* @param[in] origin The original place url handle
* @param[out] cloned A cloned place url handle
* @deprecated Deprecated since 8.0.
* @brief Gets the place URL path.
* @details This function gets the place URL path.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a path must be released using free().
* @param[in] url The handle to place url handle
* @param[out] path The place url path
* @deprecated Deprecated since 8.0.
* @brief Gets the place URL description.
* @details This function gets the place URL description.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a desc must be released using free().
* @param[in] url The handle to place url handle
* @param[out] desc The place url description
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating place type while searching the place.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_PLACE_FILTER_TYPE "MAPS_PLACE_FILTER_TYPE"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating sorting key while searching the place.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_PLACE_FILTER_SORT_BY "MAPS_PLACE_FILTER_SORT_BY"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating free-form address to avoid while computing the route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID "MAPS_ROUTE_FREEFORM_ADDR_TO_AVOID"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating structured address to avoid while computing the route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID "MAPS_ROUTE_STRUCTED_ADDR_TO_AVOID"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating circular geographical area to avoid while computing the route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_CIRCLE_AREA_TO_AVOID "MAPS_ROUTE_CIRCLE_AREA_TO_AVOID"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating rectangular geographical area to avoid while computing the route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The values are consist of top-left and bottom-right geo-coordinates, and comma or semicolon are used to delimit each value.\n
* Format : {top-left latitude};{top-left longitude};{bottom-right latitude};{bottom-right longitude}\n
* Example : "37.125;127.0572;37.37.102;127.0672"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that route should be computed within a specified bounding box.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_GEOMETRY_BOUNDING_BOX "MAPS_ROUTE_GEOMETRY_BOUNDING_BOX"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that geometry parameters should be retrieved while route processing.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_GEOMETRY_RETRIEVAL "MAPS_ROUTE_GEOMETRY_RETRIEVAL"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that route should be computed with geometry instructions.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_INSTRUCTION_GEOMETRY "MAPS_ROUTE_INSTRUCTION_GEOMETRY"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that route should be computed with bounding box instructions.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX "MAPS_ROUTE_INSTRUCTION_BOUNDING_BOX"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that route should be computed correspondingly to retrieval instructions.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
#define MAPS_ROUTE_INSTRUCTION_RETRIEVAL "MAPS_ROUTE_INSTRUCTION_RETRIEVAL"
/**
* @deprecated Deprecated since 8.0.
* @brief Definition for the name of the preference indicating that route should be computed in accordance to real time traffic.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To enable realtime traffic, set the value to "true".
* Otherwise, set it to "false".
*/
* @details The Maps Preference handle can be obtained via call of maps_preference_create().\n
* To release the handle use maps_preference_destroy().\n
* To clone the handle use maps_preference_clone().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see maps_preference_create()
* @see maps_preference_destroy()
* @see maps_preference_clone()
* @deprecated Deprecated since 8.0.
* @brief Enumeration for allowed distance units.
* @details This enumeration represents allowed distance units used in Maps Services.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see #maps_preference_h
*/
typedef enum _maps_distance_unit_e {
* @deprecated Deprecated since 8.0.
* @brief Enumeration for allowed route optimization option.
* @details This enumeration represents allowed route optimization option used in Route Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see #_maps_route_transport_mode_e
* @see #_maps_route_feature_weight_e
* @see #_maps_route_request_feature_e
* @deprecated Deprecated since 8.0.
* @brief Enumeration for preferable route types.
* @details This enumeration represents allowed route types used in Route Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see #_maps_distance_unit_e
* @see #_maps_route_feature_weight_e
* @see #_maps_route_request_feature_e
* @deprecated Deprecated since 8.0.
* @brief Enumeration for route feature weights.
* @details This enumeration represents allowed route feature weights used in Route Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see #_maps_distance_unit_e
* @see #_maps_route_transport_mode_e
* @see #_maps_route_request_feature_e
* @deprecated Deprecated since 8.0.
* @brief Enumeration for route features.
* @details This enumeration represents allowed route features used in Route Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see #_maps_distance_unit_e
* @see #_maps_route_transport_mode_e
* @see #_maps_route_feature_weight_e
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Maps Properties.
* @details This callback is invoked while iterating through the list of Maps Properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a key and @a value must be released using free() and corresponding release method for property value correspondingly.
* @param[in] index The current index of property
* @param[in] total The total amount of properties
* @deprecated Deprecated since 8.0.
* @brief Creates a new maps preference handle.
* @details This function creates a new maps preference handle and allocates all needed resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a preference must be released using maps_preference_destroy().\n
* @a preference may be cloned using maps_preference_clone().
* @param[out] preference A newly created preference handle
* @deprecated Deprecated since 8.0.
* @brief Destroys the maps preference handle and releases all its resources.
* @details This function destroys the maps preference handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the maps preference handle.
* @details This function clones the maps preference handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_preference_destroy().
* @param[in] origin The original preference handle
* @param[out] cloned A cloned preference handle
* @deprecated Deprecated since 8.0.
* @brief Gets the distance unit.
* @details This function gets the maps distance unit.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] unit The distance unit
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the language.
* @details This function gets the maps language.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a language must be released using free().
* @param[in] preference The preference handle
* @param[out] language The language
* @deprecated Deprecated since 8.0.
* @brief Gets the max amount of results.
* @details This function gets the max amount of results.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] max_results The max amount of results
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the country code.
* @details This function gets the country code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a country_code must be released using free().
* @param[in] preference The preference handle
* @param[out] country_code The country code
* @deprecated Deprecated since 8.0.
* @brief Gets the route optimization.
* @details This function gets the route optimization.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] optimization The route optimization
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route transport mode.
* @details This function gets the route transport mode.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] transport_mode The transport mode
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route feature weight.
* @details This function gets the route feature weight.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] feature_weight The feature weight
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route feature.
* @details This function gets the route feature.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[out] feature The feature
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the enable status of alternative routes.
* @details This function retrieves the enable status of alternative route.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] preference The preference handle
* @param[out] enable The enable status
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the maps preference value by key.
* @details This function gets the maps preference value by key.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a value must be released using free().
* @param[in] preference The preference handle
* @param[in] key The preference key
* @deprecated Deprecated since 8.0.
* @brief Retrieves all maps properties.
* @details This function retrieves all maps properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The properties will be delivered via maps_preference_properties_cb().
* @param[in] preference The preference handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Sets the maps distance unit.
* @details This function sets the maps distance unit.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] unit The distance unit
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the maps language.
* @details This function sets the maps language.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] language The maps language.
* A language is specified as an ISO 3166 alpha-2 two letter country-code
* @deprecated Deprecated since 8.0.
* @brief Sets the max amount of results.
* @details This function sets the max amount of results.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] max_results The max amount of results
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the maps country code.
* @details This function sets the maps country code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] country_code The maps country code
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the route optimization.
* @details This function sets the route optimization.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] optimization The route optimization
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the route transport mode.
* @details This function sets the route transport mode.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] transport_mode The route transport mode
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the route feature weight.
* @details This function sets the route feature weight.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] feature_weight The route feature weight
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the route feature.
* @details This function sets the route feature.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] feature The route feature
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the enable status of alternative routes.
* @details This function sets the alternative routes status.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] preference The preference handle
* @param[in] enable The value to set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the preference value by key.
* @details This function sets the preference value assigned with a specified key.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] preference The preference handle
* @param[in] key The key
* @param[in] value The value
* @deprecated Deprecated since 8.0.
* @brief The Route handle.
* @details The handle of Route instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_route_destroy().\n
* To clone the handle use maps_route_clone().
* @see maps_route_destroy()
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the path of the Route.
* @details This callback is invoked while iterating through the list of coordinates, composing the Route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a coordinates must be released using maps_coordinates_destroy().\n
* To use @a coordinates outside this function, clone it with maps_coordinates_clone().
* @param[in] index The current index of path point
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the segments of the Route.
* @details This callback is invoked while iterating through the list of segments, composing the Route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a segment is valid only in this function and must be released using maps_route_segment_destroy().\n
* To use @a segment outside this function, clone it with maps_route_segment_clone().
* @param[in] index The current index of segment
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of Route Properties.
* @details This callback is invoked while iterating through the list of Route Properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a key and @a value must be released using free() and corresponding release method for property value correspondingly.\n
* To use @a key and @a value outside this function, you should clone it.
* @param[in] index The current index of property
* @deprecated Deprecated since 8.0.
* @brief Destroys the route handle and releases all its resources.
* @details This function destroys the route handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] route The route handle
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the route handle.
* @details This function clones the route handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_route_destroy().
* @param[in] origin The original route handle
* @param[out] cloned A cloned route handle
* @deprecated Deprecated since 8.0.
* @brief Gets the route ID.
* @details This function gets the route ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a id must be released using free().
* @param[in] route The route handle
* @param[out] route_id The ID of route
* @deprecated Deprecated since 8.0.
* @brief Gets the route origin.
* @details This function gets the route origin.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a origin must be released using maps_coordinates_destroy().
* @param[in] route The route handle
* @param[out] origin The origin of route
* @deprecated Deprecated since 8.0.
* @brief Gets the route destination.
* @details This function gets the route destination.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a destination must be released using maps_coordinates_destroy().
* @param[in] route The route handle
* @param[out] destination The destination of route
* @deprecated Deprecated since 8.0.
* @brief Gets the route bounding box.
* @details This function gets the route bounding box.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a bounding_box must be released using maps_area_destroy().
* @param[in] route The route handle
* @param[out] bounding_box The bounding box of route
* @deprecated Deprecated since 8.0.
* @brief Gets the route transport mode.
* @details This function gets the route transport mode.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] route The route handle
* @param[out] transport_mode The transport mode
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route total distance.
* @details This function gets the route total distance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] route The route handle
* @param[out] total_distance The distance of route. You can get the distance unit by route_get_distance_unit()
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route total duration.
* @details This function gets the route total duration.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] route The route handle
* @param[out] total_duration The duration
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route distance units.
* @details This function gets the route distance units.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] route The route handle
* @param[out] distance_unit The distance units
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Retrieves all properties.
* @details This function retrieves all route properties.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The properties will be delivered via maps_route_properties_cb().
* @param[in] route The route handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all coordinates of the path.
* @details This function retrieves all coordinates of the route path.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The coordinates will be delivered via maps_route_path_cb().
* @param[in] route The route handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all segments of the route.
* @details This function retrieves all segments of the route.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The segments will be delivered via maps_route_path_cb().
* @param[in] route The route handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief The Route Maneuver handle.
* @details The handle of Route Maneuver instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_route_maneuver_destroy().\n
* To clone the handle use maps_route_maneuver_clone().
* @see maps_route_maneuver_destroy()
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for direction type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum {
MAPS_ROUTE_DIRECTION_NONE, /**< Indicates unknown direction */
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for the turn type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum {
MAPS_ROUTE_TURN_TYPE_NONE, /**< Indicates unknown instruction. */
* @deprecated Deprecated since 8.0.
* @brief Destroys the route Maneuver handle and releases all its resources.
* @details This function destroys the route Maneuver handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maneuver The Maneuver handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the route Maneuver handle.
* @details This function clones the route Maneuver handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_route_maneuver_destroy().
* @param[in] origin The original Maneuver handle
* @param[out] cloned A cloned Maneuver handle
* @deprecated Deprecated since 8.0.
* @brief Gets the route Maneuver direction ID.
* @details This function gets the route Maneuver direction ID.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maneuver The Maneuver handle
* @param[out] direction_id The direction ID
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route Maneuver turn type.
* @details This function gets the route Maneuver turn type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maneuver The Maneuver handle
* @param[out] turn_type The turn type
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route Maneuver position.
* @details This function gets the route Maneuver position.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a position must be released using maps_coordinates_destroy().
* @param[in] maneuver The Maneuver handle
* @param[out] position The start position of the Maneuver
* @deprecated Deprecated since 8.0.
* @brief Gets the road name of the route Maneuver.
* @details This function gets the road name of the route Maneuver.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a road_name must be released using free().
* @param[in] maneuver The Maneuver handle
* @param[out] road_name The current road name of the Maneuver handle
* @deprecated Deprecated since 8.0.
* @brief Gets the instruction text (narrative) of the route Maneuver.
* @details This function gets the instruction text (narrative) of the route Maneuver.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a instruction_text must be released using free().
* @param[in] maneuver The Maneuver handle
* @param[in] instruction_text The instruction text
* @deprecated Deprecated since 8.0.
* @brief Gets the route Maneuver locale.
* @details This function gets the route Maneuver locale.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a locale must be released using free().
* @param[in] maneuver The Maneuver handle
* @param[out] locale The languages of instruction text and street name
* @deprecated Deprecated since 8.0.
* @brief Gets the time to next instruction of the route Maneuver.
* @details This function gets the time to next instruction of the route Maneuver.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maneuver The Maneuver handle
* @param[out] time_to_next_instruction The time to next instruction on the given Maneuver handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the distance to next instruction of the route Maneuver.
* @details This function gets the distance to next instruction of the route Maneuver.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maneuver The Maneuver handle
* @param[out] distance_to_next_instruction The distance from the current Maneuver to the next Maneuver
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief The Route Segment handle.
* @details The handle of Route Segment instance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To release the handle use maps_route_segment_destroy().\n
* To clone the handle use maps_route_segment_clone().
* @see maps_route_segment_destroy()
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the path of the Route Segment.
* @details This callback is invoked while iterating through the list of coordinates, composing the Route Segment.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a coordinates must be released using maps_coordinates_destroy().\n
* To use @a coordinates outside this function, clone it with maps_coordinates_clone().
* @param[in] index The current index of coordinates list
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the Maneuvers of the Route Segment.
* @details This callback is invoked while iterating through the list of Maneuvers, composing the Route Segment.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a Maneuver is valid only in this function and must be released using maps_route_maneuver_destroy().\n
* To use @a Maneuver outside this function, clone it with maps_route_maneuver_clone().
* @param[in] index The current index of Maneuvers list
* @deprecated Deprecated since 8.0.
* @brief Destroys the route segment handle and releases all its resources.
* @details This function destroys the route segment handle and releases all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] segment The segment handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the route segment handle.
* @details This function clones the route handle @a origin and all its resources.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a cloned must be released using maps_route_segment_destroy().
* @param[in] origin The original segment handle
* @param[out] cloned A cloned segment handle
* @deprecated Deprecated since 8.0.
* @brief Gets the route segment origin.
* @details This function gets the route segment origin.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a origin must be released using maps_coordinates_destroy().
* @param[in] segment The segment handle
* @param[out] origin The origin of segment
* @deprecated Deprecated since 8.0.
* @brief Gets the route segment destination.
* @details This function gets the route segment destination.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a destination must be released using maps_coordinates_destroy().
* @param[in] segment The segment handle
* @param[out] destination The destination of segment
* @deprecated Deprecated since 8.0.
* @brief Gets the route segment bounding box.
* @details This function gets the route segment bounding box.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a bounding_box must be released using maps_area_destroy().
* @param[in] segment The segment handle
* @param[out] bounding_box The bounding box of segment
* @deprecated Deprecated since 8.0.
* @brief Gets the route segment distance.
* @details This function gets the route segment distance.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] segment The segment handle
* @param[out] distance The distance of segment
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the route segment duration.
* @details This function gets the route segment duration.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] segment The segment handle
* @param[out] duration The distance of segment
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Retrieves all coordinates of the path.
* @details This function retrieves all coordinates of the route segment path.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The coordinates will be delivered via maps_route_segment_path_cb().
* @param[in] segment The segment handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Retrieves all Maneuvers of the path.
* @details This function retrieves all Maneuvers of the route segment path.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The coordinates will be delivered via maps_route_segment_maneuver_cb().
* @param[in] segment The segment handle
* @param[in] callback The callback function to invoke
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for maps requests available in the Maps Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum _maps_service_e {
MAPS_SERVICE_GEOCODE, /**< Indicates that maps_service_geocode() service is allowed */
MAPS_SERVICE_SEARCH_ROUTE, /**< Indicates that maps_service_search_route() service is allowed */
MAPS_SERVICE_SEARCH_ROUTE_WAYPOINTS, /**< Indicates that maps_service_search_route_waypoints() service is allowed */
MAPS_SERVICE_CANCEL_REQUEST, /**< Indicates that maps_service_cancel_request() service is allowed */
- MAPS_SERVICE_MULTI_REVERSE_GEOCODE, /**< Indicates that maps_service_multi_reverse_geocode() service is allowed @if MOBILE (Since 3.0) @endif */
- MAPS_SERVICE_SEARCH_PLACE_LIST, /**< Indicates that maps_service_search_place_list() service is allowed @if MOBILE (Since 3.0) @endif */
- MAPS_SERVICE_SEARCH_GET_PLACE_DETAILS, /**< Indicates that maps_service_search_get_place_details() service is allowed @if MOBILE (Since 3.0) @endif */
+ MAPS_SERVICE_MULTI_REVERSE_GEOCODE, /**< Indicates that maps_service_multi_reverse_geocode() service is allowed (Since 3.0) @endif */
+ MAPS_SERVICE_SEARCH_PLACE_LIST, /**< Indicates that maps_service_search_place_list() service is allowed (Since 3.0) @endif */
+ MAPS_SERVICE_SEARCH_GET_PLACE_DETAILS, /**< Indicates that maps_service_search_get_place_details() service is allowed (Since 3.0) @endif */
- MAPS_SERVICE_VIEW = 0x100, /**< Indicates that maps view service is allowed @if MOBILE (Since 3.0) @endif */
- MAPS_SERVICE_VIEW_SNAPSHOT /**< Indicates that maps view snapshot service is allowed @if MOBILE (Since 3.0) @endif */
+ MAPS_SERVICE_VIEW = 0x100, /**< Indicates that maps view service is allowed (Since 3.0) @endif */
+ MAPS_SERVICE_VIEW_SNAPSHOT /**< Indicates that maps view snapshot service is allowed (Since 3.0) @endif */
} maps_service_e;
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for maps features available in the Maps Service.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
*/
typedef enum _maps_service_data_e {
MAPS_PLACE_ADDRESS, /**< Indicates the availability of address value in the Place data */
MAPS_ROUTE_SEGMENTS_PATH, /**< Indicates that the Route Data Structure is defined as a list of Segments while each segment is defined as a Path */
MAPS_ROUTE_SEGMENTS_MANEUVERS, /**< Indicates that the Route Data Structure is defined as a list of Segments while each segment is defined as a list of Maneuvers*/
- MAPS_VIEW_TRAFFIC = 0x100, /**< Indicates the availability of traffic information on the Map @if MOBILE (Since 3.0) @endif */
- MAPS_VIEW_PUBLIC_TRANSIT, /**< Indicates the availability of public transit information on the Map @if MOBILE (Since 3.0) @endif */
- MAPS_VIEW_BUILDING, /**< Indicates the availability of 3D building drawable on the Map @if MOBILE (Since 3.0) @endif */
- MAPS_VIEW_SCALEBAR /**< Indicates the availability of scale bar on the Map @if MOBILE (Since 3.0) @endif */
+ MAPS_VIEW_TRAFFIC = 0x100, /**< Indicates the availability of traffic information on the Map (Since 3.0) @endif */
+ MAPS_VIEW_PUBLIC_TRANSIT, /**< Indicates the availability of public transit information on the Map (Since 3.0) @endif */
+ MAPS_VIEW_BUILDING, /**< Indicates the availability of 3D building drawable on the Map (Since 3.0) @endif */
+ MAPS_VIEW_SCALEBAR /**< Indicates the availability of scale bar on the Map (Since 3.0) @endif */
} maps_service_data_e;
* @deprecated Deprecated since 8.0.
* @brief Called when requesting available Maps Providers.
* @details A Maps Service invokes this callback iteratively as long as available Maps Providers exist.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The string @a maps_provider must be released using free().
* @param[in] maps_provider The info of Maps Provider
* @param[in] user_data The user data passed from maps_service_foreach_provider()
* @deprecated Deprecated since 8.0.
* @brief Gets available Maps Providers.
* @details This function delivers available Maps Providers via maps_service_provider_info_cb() callback.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] callback The callback function to receive available Maps Providers information
* @param[out] user_data The user data to be passed to the callback function
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Called with the information about user's consent.
* @details The Maps Service invokes this callback when the information about user's consent is obtained.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] consented The value of User Consent
* @param[in] maps_provider The name of Maps Provider
* @param[in] user_data The user data passed from maps_service_request_user_consent()
* the user can decide whether to agree or not. Then the result is saved and maps_service_request_user_consent_cb()
* is called. If the user has already agreed, the popup is not shown and only the callback is called.
* The request is asynchronous.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks Available map providers can be obtained with maps_service_foreach_provider().
* @brief Creates a new Maps Service and assigns it with a handle.
* @details While Maps Service is being created, a Maps Provider is initialized and linked with Maps Service handle.
* A Maps Service handle is used to query Maps Provider performing services, such as Geocoding, Searching Places, and Routing.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/network.get
* @deprecated Deprecated since 8.0.
* @brief Destroys the Maps Service handle and releases all its resources.
* @details This function releases all used resources of the Maps Service and Maps Provider.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] maps The Maps Service handle to destroy
* @brief Sets the Maps Key to be used in the requests of Maps Service.
* @details This function sets the Maps Provider's Key which will be used in each Maps Service request to Maps Provider.\n
* Maps Key can be obtained with maps_service_get_provider_key().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks To get the @a provider_key, refer to corresponding Maps Provider documentation.\n
* To get app_id and app_code of HERE, visit
* <a href="https://developer.here.com/" target=_blank>https://developer.here.com/</a>,
* @brief Gets the Maps Key which is to be used in the Maps Service requests
* @details This function gets the Maps Key which is to be used in each Maps Service request to Maps Provider.\n
* Maps Key can be set with maps_service_set_provider_key().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The string @a provider_key must be released using free().\n
* @a maps_service_get_provider_key is always synchronous function.
* @param[in] maps The Maps Service handle
* @deprecated Deprecated since 8.0.
* @brief Sets the Maps Preference.
* @details This function sets the Maps Preferences which are used in each Maps Service request to Maps Provider.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @param[in] maps The handle of Maps Service
* @param[in] preference The handle of Maps Preference
* @return @c 0 on success,
* @brief Gets the Maps Preference.
* @details This function gets the Maps Preferences which are used in each Maps Service request to Maps Provider.\n
* Preferences can be set with maps_service_set_preference().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a preference must be released using maps_preference_destroy().\n
* @a maps_service_get_preference is always synchronous function.
* @param[in] maps The handle of Maps Service
* @deprecated Deprecated since 8.0.
* @brief Checks if the Maps Service supports a request.
* @details This function checks if the Maps Service supports a specified request.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a maps_service_provider_is_service_supported is always synchronous function.
* @param[in] maps The handle of Maps Service
* @param[in] service The service to be checked
* @deprecated Deprecated since 8.0.
* @brief Checks if the Maps Service supports a data feature.
* @details This function checks if the Maps Service supports a specified data feature.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks @a maps_service_provider_is_data_supported is always a synchronous function.
* @param[in] maps The handle of Maps Service
* @param[in] data The data feature to be checked
* @deprecated Deprecated since 8.0.
* @brief Cancels the service request.
* @details This function cancels the service request initiated by geocoding and searching places and routes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] maps The Maps Service handle
/**
* @ingroup CAPI_MAPS_SERVICE_MODULE
* @defgroup CAPI_MAPS_GEOCODER_MODULE Geocoder
- * @if WEARABLE
* @section CAPI_MAPS_SERVICE_MODULE_FEATURE Related Features
* This API is related with the following features:\n
* - %http://tizen.org/feature/network.internet\n
* please define the features in your manifest file using the manifest editor in the SDK.\n
* More details on featuring your application can be found from
* <a href="https://docs.tizen.org/application/tizen-studio/native-tools/manifest-text-editor#feature-element"><b>Feature Element</b>.</a>
- * @endif
* @addtogroup CAPI_MAPS_GEOCODER_MODULE
* @{
* @brief This provides APIs for Geocoder Service.
* @brief Called once for each position coordinates converted from the given address information.
* @details The Maps Service invokes this callback while iterating through the list of obtained coordinates of the specified place.\n
* If search is failed, the value of @a total is 0 and @a coordinates is NULL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The parameter @a coordinates must be released using maps_coordinates_destroy().\n
* This error code will be reported.\n
* #MAPS_ERROR_NONE \n
* @brief Called when the address information is converted from position information.
* @details The Maps Service invokes this callback when the address is obtained from the specified coordinates.\n
* If search is failed, the value of @a total is 0 and @a address is NULL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The parameter @a address must be released using maps_address_destroy().\n
* This error code will be reported. \n
* #MAPS_ERROR_NONE \n
* @brief Gets the position coordinates for a given address.\n
* The request is asynchronous.
* @details This function obtains position coordinates for a given free-formed address string.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets the position for a given address within the specified bounding box.\n
* The request is asynchronous.
* @details This function obtains position coordinates for a given free-formed address string within the specified bounding box.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets the position coordinates for a given address.\n
* The request is asynchronous.
* @details This function obtains position coordinates for a given structured address.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets the address for a given position coordinates.\n
* The request is asynchronous.
* @details This function obtains structured address information for a given position coordinates.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @details The Maps Service invokes this callback once when gets the response from map service provider.\n
* The value of @a total is same with requested coordinates list size.
* Even though one of address is not provided valid address handle is retrieved.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks You can get the respective address information of @a address_list using maps_address_list_foreach().\n
* This error code will be reported. \n
* #MAPS_ERROR_NONE \n
* @brief Gets the address list for a given position coordinates list.\n
* The request is asynchronous.
* @details This function obtains structured address information.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
/**
* @ingroup CAPI_MAPS_SERVICE_MODULE
* @defgroup CAPI_MAPS_PLACE_MODULE Places
- * @if WEARABLE
* @section CAPI_MAPS_SERVICE_MODULE_FEATURE Related Features
* This API is related with the following features:\n
* - %http://tizen.org/feature/network.internet\n
* please define the features in your manifest file using the manifest editor in the SDK.\n
* More details on featuring your application can be found from
* <a href="https://docs.tizen.org/application/tizen-studio/native-tools/manifest-text-editor#feature-element"><b>Feature Element</b>.</a>
- * @endif
* @addtogroup CAPI_MAPS_PLACE_MODULE
* @{
* @brief This provides APIs for Place Service.
* @brief Called for each result of Place Search request.
* @details The Maps Service invokes this callback while iterating through the set of obtained Place data.\n
* If search is failed, the value of @a total is 0 and @a place is NULL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The parameter @a place must be released using maps_place_destroy().\n
* This error code will be reported.\n
* #MAPS_ERROR_NONE \n
* @brief Called for Place list of Place Search request.
* @details The Maps Service invokes this callback when the Place data obtained from the specified coordinates.\n
* If search is failed, the value of @a total is 0 and @a place_list is NULL.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The parameter @a place_list must be released using maps_place_list_destroy().\n
* This error code will be reported.\n
* #MAPS_ERROR_NONE \n
* @brief Called for Place detail information of Place Search request.
* @details The Maps Service invokes this callback when the Place detail data obtained from the specified uri.\n
* If search is failed, @a place is NULL.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The parameter @a place must be released using maps_place_destroy().\n
* This error code will be reported.\n
* #MAPS_ERROR_NONE \n
* @brief Queries a Place information by a coordinates position and a distance.\n
* The request is asynchronous.
* @details This function obtains the Place information for a specified distance around a given coordinates position.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Queries a Place information by a coordinates boundary.\n
* The request is asynchronous.
* @details This function obtains the Place information for a specified coordinates boundary.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Queries a Place information by a free-formed address string.\n
* The request is asynchronous.
* @details This function obtains the Place information for a specified free-formed address string.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Queries a brief Place information by a coordinates boundary./n
* The request is asynchronous.
* @details This function obtains the brief Place information for a specified coordinates boundary.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Queries a Detail Place information by a place uri.\n
* The request is asynchronous.
* @details This function obtains the Detail Place information for a specified place uri.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
/**
* @ingroup CAPI_MAPS_SERVICE_MODULE
* @defgroup CAPI_MAPS_ROUTE_MODULE Routes
- * @if WEARABLE
* @section CAPI_MAPS_SERVICE_MODULE_FEATURE Related Features
* This API is related with the following features:\n
* - %http://tizen.org/feature/network.internet\n
* please define the features in your manifest file using the manifest editor in the SDK.\n
* More details on featuring your application can be found from
* <a href="https://docs.tizen.org/application/tizen-studio/native-tools/manifest-text-editor#feature-element"><b>Feature Element</b>.</a>
- * @endif
* @addtogroup CAPI_MAPS_ROUTE_MODULE
* @{
* @brief This provides APIs for Route Service.
* @brief Called when the requested routes are found.
* @details The Maps Service invokes this callback while iterating through the set of obtained Routes.\n
* If search is failed, the value of @a total is 0 and @a route is NULL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @remarks The parameter @a route must be released using maps_route_destroy().\n
* This error code will be reported. \n
* #MAPS_ERROR_NONE \n
* @brief Queries the Route from origin coordinates to destination.\n
* The request is asynchronous.
* @details This function gets the Route information for a specified origin and destination coordinates.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Queries the Route, passing through a specified way points.\n
* The request is asynchronous.
* @details This function gets the Route information for the Route, passing through a specified set of way points.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief The Maps Service handle
* @details The Maps Service handle can be created by calling of maps_service_create().\n
* To release the handle use maps_service_destroy().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 2.4
* @see maps_service_create()
* @see maps_service_destroy()
*/
* @deprecated Deprecated since 8.0.
* @brief The View handle
* @details The handle of View instance.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks To release the handle use maps_view_destroy().
* @see maps_view_create()
* @see maps_view_destroy()
/**
* @ingroup CAPI_MAPS_SERVICE_MODULE
* @defgroup CAPI_MAPS_VIEW_MODULE View
- * @if WEARABLE
* @section CAPI_MAPS_SERVICE_MODULE_FEATURE Related Features
* This API is related with the following features:\n
* - %http://tizen.org/feature/network.internet\n
* please define the features in your manifest file using the manifest editor in the SDK.\n
* More details on featuring your application can be found from
* <a href="https://docs.tizen.org/application/tizen-studio/native-tools/manifest-text-editor#feature-element"><b>Feature Element</b>.</a>
- * @endif
* @file maps_view.h
* @brief This file contains the top level functions of View API.
* @addtogroup CAPI_MAPS_VIEW_MODULE
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for View types (themes).
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_type_e {
MAPS_VIEW_TYPE_NORMAL, /**< Indicates the normal street theme */
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of visual objects of the View.
* @details This callback is invoked while iterating through the list of visual objects added to the View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] index The current index of the visual object starts from 0
* @param[in] total The total amount of visual objects
* @param[in] object The visual object
* @deprecated Deprecated since 8.0.
* @brief Called when the View event occurs.
* @details The View Panel invokes this callback when the map event occurs.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a event_data will be released automatically after this callback is terminated.\n
* To use @a event_data outside this function, clone it with maps_view_event_data_clone().
* @param[in] type The new type of callback, listed in #maps_view_event_type_e
* maps_view_set_zoom_level() and maps_view_set_orientation() respectively.\n
* To change View theme, size and visibility properties use
* maps_view_set_type() and maps_view_set_visibility() respectively.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks The @a View must be released using maps_view_destroy().
* @deprecated Deprecated since 8.0.
* @brief Destroys the View.
* @details This function destroys the View, releases its handle and all allocated resources, unlinks the View from the instance of maps service.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] view The View handle to destroy
* @deprecated Deprecated since 8.0.
* @brief Centers the map on a given geographical coordinates.
* @details This function centers the map on a given geographical coordinates using current zoom and orientation.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Gets the central coordinates of a map.
* @details This function gets the current central coordinates of a map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a coordinates must be released using maps_coordinates_destroy().
* @param[in] view The view handle
* @param[out] coordinates The pointer to #maps_coordinates_h in which to
* the function returns #MAPS_ERROR_INVALID_PARAMETER error.\n
* To check the range of allowed zoom level use maps_view_get_min_zoom_level()
* and maps_view_get_max_zoom_level().
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Gets zoom level of the map.
* @details This function gets the current integer zoom level of the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] level The pointer to an integer in which to store the current zoom level
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the minimal zoom level of the map.
* @details This function sets the minimally allowed zoom level of the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] view The view handle
* @deprecated Deprecated since 8.0.
* @brief Gets the minimal zoom level of the map.
* @details This function gets the minimally allowed zoom level of the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] min_zoom_level The pointer to an integer in which to store the minimally allowed zoom level
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the maximal zoom level of the map.
* @details This function sets the maximally allowed zoom level of the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] view The view handle
* @deprecated Deprecated since 8.0.
* @brief Gets the maximal zoom level of the map.
* @details This function gets the maximally allowed zoom level of the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] max_zoom_level The pointer to an integer in which to store the maximally allowed zoom level
* @return @c 0 on success,
* @details This function sets the rotation angle of the View.\n
* If the specified rotation angle exceeds the [0..360] range,
* the function returns #MAPS_ERROR_INVALID_PARAMETER error.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Gets the orientation.
* @details This function gets the current map rotation angle on the View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] rotation_angle The pointer to a double in which to store the current rotation angle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Converts screen coordinates to the geographical coordinates.
* @details This function converts screen coordinates to the geographical coordinates accordingly to the current map zoom and orientation.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks The @a coordinates must be released using maps_coordinates_destroy().
* @brief Converts geographical coordinates to the screen coordinates.
* @details This function converts geographical coordinates to the screen
* coordinates accordingly to the current map zoom and orientation.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @param[in] view The view handle
* @deprecated Deprecated since 8.0.
* @brief Sets View type.
* @details This function switches the View to a specified type, one of listed in #maps_view_type_e enumeration.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets View type.
* @details This function gets the type of the given View.\n
* The type options are defined in the #maps_view_type_e enumeration.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] type The pointer to a #maps_view_type_e in which to store current view type
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Indicates whether the map should show the 3D buildings layer.
* @details This function is called to indicate whether 3D buildings should be shown as a layer on the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Queries whether the map has the 3D buildings layer enabled.
* @details This function checks whether the map is set to show the 3D buildings layer.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] enable The pointer to a boolean in which to store the enable status
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Indicates whether the map should show the traffic layer.
* @details This function is called to indicate whether traffic conditions should be shown as a layer on the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Queries whether the map has the traffic layer enabled.
* @details This function checks whether the map is set to show the traffic layer.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] enable The pointer to a boolean in which to store the enable status
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Indicates whether the map should show the public transit layer.
* @details This function is called to indicate whether public transit routes should be shown as a layer on the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Queries whether the map has the public transit layer enabled.
* @details This function checks whether the map is set to show the public transit routes layer.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] enable The pointer to a boolean in which to store the enable status
* @return @c 0 on success,
* @brief Sets View language.
* @details This function sets the language to the given View.\n
* Note that map display language is different from places and route language.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets View language.
* @details This function gets the language set to the View.\n
* Note that map display language is different from places and route language.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a language should be freed using free().
* @param[in] view The view handle
* @param[out] language The pointer to a char* in which to store the language string value
* @deprecated Deprecated since 8.0.
* @brief Enables or disables scalebar.
* @details This function enables or disables scalebar.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @deprecated Deprecated since 8.0.
* @brief Gets whether the scalebar is enabled or not.
* @details This function gets whether the scalebar is enabled or not.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] enabled The pointer to a boolean in which to store the enable status
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the View port.
* @details This function gets the View port as a pointer on Evas_Object.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] viewport The pointer to Evas_Object in which to store the View port
* @return @c 0 on success,
* @brief Sets geometry of View port.
* @details This function set the position and (rectangular) size of the given View.\n
* The position, naturally, will be relative to the top left corner of the parent window.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* %http://tizen.org/privilege/internet \n
* @brief Gets geometry of View port.
* @details This function retrieves the position and (rectangular) size of the given View.\n
* The position, naturally, will be relative to the top left corner of the parent window.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks Use NULL pointers on the geometry components you're not interested in.
* @param[in] view The view handle
* @param[out] x X screen coordinate for the top left corner of View
* @deprecated Deprecated since 8.0.
* @brief Moves the View.
* @details This function moves View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks Newly created View port has the size of its parent.
* @param[in] view The view handle
* @param[in] x The new x position, in screen units
* @deprecated Deprecated since 8.0.
* @brief Resizes the View.
* @details This function changes the size of the given View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks Newly created View port has the size of its parent.
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice \n
* @deprecated Deprecated since 8.0.
* @brief Shows or hides the View.
* @details This function changes the visibility of View on the screen.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[in] visible The new visibility of the View
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the View visibility.
* @details This function retrieves whether or not the given View is visible.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[out] visible The pointer to a boolean in which to store the visibility of the View
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the event callback.
* @details This function sets the callback which will be invoked every time the View processes the user's gesture, action and objects over the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks To unregister the callback use maps_view_unset_event_cb().
* @param[in] view The view handle
* @param[in] type The event type
* @deprecated Deprecated since 8.0.
* @brief Unsets the event callback.
* @details This function unsets the event callback.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[in] type The event type
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Enables or disables the map gesture.
* @details This function enables or disables the map gesture.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[in] gesture The user gesture, one of listed in #maps_view_gesture_e
* @param[in] enabled The enable status
* @deprecated Deprecated since 8.0.
* @brief Checks whether the map gesture is enabled or not.
* @details This function checks whether the map gesture is enabled or not.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] view The view handle
* @param[in] gesture The user gesture, one of listed in #maps_view_gesture_e
* @param[out] enabled The pointer to a boolean in which to store the enable status
* @deprecated Deprecated since 8.0.
* @brief Adds a visual object on the map.
* @details This function adds a visual object on the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks The @a object handle will be released automatically when the view is destroyed in the maps_view_destroy().
* @deprecated Deprecated since 8.0.
* @brief Removes a visual object from the map.
* @details This function removes a visual object from the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks The @a object handle will be released automatically by the View.
* @deprecated Deprecated since 8.0.
* @brief Removes all visual objects from the map.
* @details This function removes all visual object from the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks All object handles will be released automatically by the View.
* @deprecated Deprecated since 8.0.
* @brief Retrieves all visual objects on the map.
* @details This function retrieves all visual objects previously added to the map.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The objects will be delivered via maps_view_object_cb().
* @param[in] view The view handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief The View Event data handle.
* @details The handle of View Event Data instance.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks To release the handle use maps_view_event_data_destroy().\n
* To clone the handle use maps_view_event_data_clone().
* @see maps_view_event_data_destroy()
* @deprecated Deprecated since 8.0.
* @brief Enumeration for View actions.
* @details This is an enumeration of View actions capable to perform.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The View performs actions in response on user gestures, such as tap, zoom, long press, or APIs, such as set center or change zoom level.\n
* To re-assign View actions to user gestures use maps_view_set_gesture_action().
* @see #maps_view_gesture_e
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for user gestures over View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_gesture_e {
MAPS_VIEW_GESTURE_NONE, /**< Indicates the empty gesture */
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for map event types.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_event_type_e {
MAPS_VIEW_EVENT_GESTURE, /**< Indicates the gesture event callback */
* @deprecated Deprecated since 8.0.
* @brief Destroys the event data handle.
* @details This function destroys the event data handle and releases all its resources.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Clones the event handle.
* @details This function clones the event handle @a origin and all its resources.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a cloned must be released using maps_view_event_data_destroy().
* @param[in] origin The original event handle
* @param[out] cloned A cloned event handle
* @deprecated Deprecated since 8.0.
* @brief Gets the event type.
* @details This function gets the event type.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] event_type The pointer to the #maps_view_event_type_e in which to store the event type
* @return @c 0 on success,
* @brief Gets the event gesture type.
* @details This function gets the event gesture type if the event type is #MAPS_VIEW_EVENT_GESTURE or #MAPS_VIEW_EVENT_OBJECT.
* Otherwise it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] gesture_type The pointer to the #maps_view_gesture_e in which to store the gesture type
* @return @c 0 on success,
* @brief Gets the event action type.
* @details This function gets the event action type if the event type is #MAPS_VIEW_EVENT_ACTION.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] action_type The pointer to the #maps_view_action_e in which to store the action type
* @return @c 0 on success,
* @brief Gets the new map center coordinates.
* @details This function gets the new map center coordinates if the event type is #MAPS_VIEW_EVENT_ACTION.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a center should be freed using maps_coordinates_destroy().
* @param[in] event The event data handle
* @param[out] center The pointer to the #maps_coordinates_h in which to store the new center coordinates
* @brief Gets the new map center movement coordinates delta.
* @details This function gets the screen coordinates delta of map center movement if the event type is #MAPS_VIEW_EVENT_ACTION.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] delta_x The pointer to an integer in which to store the delta x
* @param[out] delta_y The pointer to an integer in which to store the delta y
* @brief Gets the event screen coordinates.
* @details This function gets the event screen coordinates if the event type is #MAPS_VIEW_EVENT_GESTURE or #MAPS_VIEW_EVENT_OBJECT.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] x The pointer to an integer in which to store the x position of the event
* @param[out] y The pointer to an integer in which to store the y position of the event
* @brief Gets the event geographic coordinates.
* @details This function gets the event geographic coordinates if the event type is #MAPS_VIEW_EVENT_GESTURE.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a coordinates should be freed using maps_coordinates_destroy().
* @param[in] event The event data handle
* @param[out] coordinates The pointer to the #maps_coordinates_h in which to store the coordinates
* @brief Gets the number of fingers, detected in the event.
* @details This function gets the number of user's fingers detected in the event if the event type is #MAPS_VIEW_EVENT_GESTURE or #MAPS_VIEW_EVENT_OBJECT.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] fingers The pointer to an integer in which to store the number of fingers, detected in the gesture
* @return @c 0 on success,
* @brief Gets zoom factor of zoom gesture or action.
* @details This function gets the corresponding zoom factor if the event type is #MAPS_VIEW_EVENT_GESTURE or #MAPS_VIEW_EVENT_ACTION.
* Otherwise, it returns the #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] zoom_factor The pointer to a double in which to store the zoom factor
* @return @c 0 on success,
* @brief Gets rotation angle of rotation gesture or action.
* @details This function gets the corresponding rotation angle if the event type is #MAPS_VIEW_EVENT_GESTURE or #MAPS_VIEW_EVENT_ACTION.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] event The event data handle
* @param[out] rotation_angle The pointer to a double in which to store the rotation angle
* @return @c 0 on success,
* @brief Gets object of event.
* @details When the event type is #MAPS_VIEW_EVENT_OBJECT, this function gets the corresponding object handle.
* Otherwise, it returns #MAPS_ERROR_INVALID_PARAMETER.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a object must not be released.
* @param[in] event The event data handle
* @param[out] object The pointer to #maps_view_object_h in which to store the object handle
* @deprecated Deprecated since 8.0.
* @brief The View Object handle.
* @details The handle of an arbitrary visual object instance.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The handle may be issued with one of following functions:
* * maps_view_object_create_marker()
* * maps_view_object_create_polygon()
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for visual object types.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_object_type_e {
MAPS_VIEW_OBJECT_POLYLINE, /**< Indicates the polyline */
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for map marker types.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_marker_type_e {
MAPS_VIEW_MARKER_PIN, /**< Indicates the pin marker type */
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for overlay types.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_overlay_type_e {
MAPS_VIEW_OVERLAY_NORMAL, /**< Indicates the normal type */
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of points of the polyline.
* @details This callback is invoked while iterating through the list of points, added to the polyline.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a point must be released using maps_coordinates_destroy().\n
* To use @a point outside this function, clone it with maps_coordinates_clone().
* @param[in] index The current index of path point
* @deprecated Deprecated since 8.0.
* @brief Called when requesting the list of points of the polygon.
* @details This callback is invoked while iterating through the list of points, added to the polygon.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a point must be released using maps_coordinates_destroy().\n
* To use @a point outside this function, clone it with maps_coordinates_clone().
* @param[in] index The current index of path point
* @brief Creates a marker visual object.
* @details This function creates a marker on a given geographical coordinates.
* The marker is specified with a given image file and a type.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a marker can be released by using maps_view_object_destroy().\n
* If added to the View using maps_view_add_object(), @a marker will be released automatically when the View is destroyed.\n
* @remarks %http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage.\n
* @deprecated Deprecated since 8.0.
* @brief Creates a polyline visual object.
* @details This function creates a polyline visual object, specified with a list of geographical coordinates, line width and color.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a polyline can be released by using maps_view_object_destroy().\n
* If added to the View using maps_view_add_object(), @a polyline will be released automatically when the View is destroyed.
* @param[in] coordinates The list of geographical coordinates
* @deprecated Deprecated since 8.0.
* @brief Creates a polygon visual object.
* @details This function creates a polygon visual object, specified with a list of geographical coordinates and fill color.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a polygon can be released by using maps_view_object_destroy().\n
* If added to the View using maps_view_add_object(), @a polygon will be released automatically when the View is destroyed.
* @param[in] coordinates The list of geographical coordinates
* @deprecated Deprecated since 8.0.
* @brief Creates an overlay object.
* @details This function creates an overlay object to contain Evas objects.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks @a overlay can be released by using maps_view_object_destroy().\n
* If added to the View using maps_view_add_object(), @a overlay will be released automatically when the View is destroyed.
* @param[in] coordinates The list of geographical coordinates
* @deprecated Deprecated since 8.0.
* @brief Destroys the object.
* @details This function destroys the object handle and releases all its resources.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] object The object handle to destroy
* @return @c 0 on success,
* otherwise a negative error value
* @deprecated Deprecated since 8.0.
* @brief Gets the object type.
* @details This function gets the object type.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] object The object handle
* @param[out] type The pointer to #maps_view_object_type_e in which to store the object type
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Shows the object.
* @details This function changes the visibility of the given object on the View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] object The object handle
* @param[in] visible The new visibility of the object
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the object visibility.
* @details This function retrieves whether or not the given object is visible.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] object The object handle
* @param[out] visible The pointer to a boolean in which to store the object visibility
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets points to the polyline.
* @details This function sets point list to the polyline.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polyline The polyline object handle
* @param[in] points The points to set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Retrieves all points, added to the polyline.
* @details This function retrieves all points, added to the polyline.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The points will be delivered via maps_view_object_polyline_point_cb().
* @param[in] polyline The polyline object handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Sets the polyline color.
* @details This function sets the polyline color on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polyline The polyline object handle
* @param[in] r The red component of the color
* @param[in] g The green component of the color
* @deprecated Deprecated since 8.0.
* @brief Gets the polyline color.
* @details This function gets the polyline color on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polyline The polyline object handle
* @param[out] r The unsigned char pointer in which to store the red component of the color, or NULL if not interested
* @param[out] g The unsigned char pointer in which to store the green component of the color, or NULL if not interested
* @deprecated Deprecated since 8.0.
* @brief Sets the polyline width.
* @details This function sets the polyline width on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polyline The polyline object handle
* @param[in] width The new width of line [1 ~ 100] (pixels)
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the polyline width.
* @details This function gets the polyline width on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polyline The polyline object handle
* @param[out] width The width of line [1 ~ 100] (pixels)
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets points to the polygon.
* @details This function sets point list to the polygon.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polygon The polygon object handle
* @param[in] points The points to set
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Retrieves all points, added to the polygon.
* @details This function retrieves all points, added to the polygon.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The objects will be delivered via maps_view_object_polygon_point_cb().
* @param[in] polygon The polygon object handle
* @param[in] callback The callback function to invoke
* @deprecated Deprecated since 8.0.
* @brief Sets polygon fill color.
* @details This function sets the polygon fill color on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polygon The polygon object handle
* @param[in] r The red component of the fill color
* @param[in] g The green component of the fill color
* @deprecated Deprecated since 8.0.
* @brief Gets polygon fill color.
* @details This function gets the polygon fill color on canvas.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] polygon The polygon data handle
* @param[in] r The unsigned char pointer in which to store the red component of the background color
* @param[in] g The unsigned char pointer in which to store the green component of the background color
* @deprecated Deprecated since 8.0.
* @brief Sets the marker coordinates.
* @details This function sets the marker geographical coordinates.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] marker The marker object handle
* @param[in] coordinates The marker geographical coordinates handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the marker screen size.
* @details This function sets the marker screen size.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks To make the marker size proportionally, use 0 as the value for the @a width or @a height parameter.
* For instance, to make the width of an marker 150 pixels, and change the height using the same proportion,
* use maps_view_object_marker_resize(marker, 150, 0).
* @deprecated Deprecated since 8.0.
* @brief Sets the marker image file path.
* @details This function sets the marker image file path.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks %http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage.\n
* @remarks %http://tizen.org/privilege/externalstorage is needed if input or output path are relevant to external storage.
* @param[in] marker The marker object handle
* @deprecated Deprecated since 8.0.
* @brief Gets the marker image file path.
* @details This function gets the marker image file path.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a file_path should be freed using free().
* @param[in] marker The marker object handle
* @param[out] file_path The marker image file path
* @deprecated Deprecated since 8.0.
* @brief Gets the marker coordinates.
* @details This function gets the marker geographical coordinates.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a coordinates should be freed using maps_coordinates_destroy().
* @param[in] marker The marker object handle
* @param[out] coordinates The pointer to #maps_coordinates_h in which to store the marker geographical coordinates
* @deprecated Deprecated since 8.0.
* @brief Gets the marker screen size.
* @details This function gets the marker size on the screen.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] marker The marker object handle
* @param[out] width The pointer to an integer in which to store the marker width on the screen in pixels
* @param[out] height The pointer to an integer in which to store the marker height on the screen in pixels
* @deprecated Deprecated since 8.0.
* @brief Gets the marker type.
* @details This function gets the marker type.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] marker The marker object handle
* @param[out] type The pointer to a maps_view_marker_type_e in which to store the marker type
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the marker z-order.
* @details This function sets the z-order.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a z_order must be in range of [-100, 100].
* @param[in] marker The marker object handle
* @param[in] z_order The z-order
* @deprecated Deprecated since 8.0.
* @brief Gets the marker z-order.
* @details This function gets the z-order.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] marker The marker object handle
* @param[out] z_order The z-order
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the Evas object.
* @details This function gets the Evas object.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a object must not be released.
* @param[in] overlay The overlay object handle
* @param[out] object The Evas object handle
* @deprecated Deprecated since 8.0.
* @brief Sets the overlay coordinates.
* @details This function sets the overlay geographical coordinates.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] overlay The overlay object handle
* @param[in] coordinates The overlay geographical coordinates handle
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the overlay coordinates.
* @details This function gets the overlay geographical coordinates.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @remarks The @a coordinates should be freed using maps_coordinates_destroy().
* @param[in] overlay The overlay object handle
* @param[out] coordinates The pointer to #maps_coordinates_h in which to store the overlay geographical coordinates
* @deprecated Deprecated since 8.0.
* @brief Sets the minimal zoom level for overlay.
* @details This function sets the minimally allowed zoom level of the map to show the overlay.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] overlay The overlay object handle
* @param[in] zoom The new minimal zoom level
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the minimal zoom level for overlay.
* @details This function gets the minimally allowed zoom level of the map to show the overlay.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] overlay The overlay object handle
* @param[out] zoom The pointer to an integer in which to store the minimally allowed zoom level.
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Sets the minimal zoom level for overlay.
* @details This function sets the minimally allowed zoom level of the map to show the overlay.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] overlay The overlay object handle
* @param[in] zoom The new minimal zoom level
* @return @c 0 on success,
* @deprecated Deprecated since 8.0.
* @brief Gets the minimal zoom level for overlay.
* @details This function gets the minimally allowed zoom level of the map to show the overlay.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @param[in] overlay The overlay object handle
* @param[out] zoom The pointer to an integer in which to store the minimally allowed zoom level
* @return @c 0 on success,
/**
* @deprecated Deprecated since 8.0.
* @brief Enumeration for snapshot file format type.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
*/
typedef enum _maps_view_snapshot_format_type_e {
MAPS_VIEW_SNAPSHOT_BMP, /**< Indicates the BMP format type */
* @brief Captures a snapshot of the Map View.\n
* The request is synchronous.
* @details This function retrieves an image of a map currently represented on the Map View.
- * @since_tizen @if MOBILE 3.0 @elseif WEARABLE 2.3.2 @endif
+ * @since_tizen 3.0
* @privlevel public
* @privilege %http://tizen.org/privilege/mapservice
* @remarks To check if Maps Provider is capable of capturing snapshots use
projects / platform / core / api / maps-service.git / commitdiff