From: Priya Kohli Date: Fri, 26 Jul 2024 05:23:35 +0000 (+0530) Subject: [9.0][maps-service] Remove conditional statements for Mobile/Wearable profile X-Git-Tag: accepted/tizen/unified/20240926.163038~1 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f18b7830b6a11d2742af15ccf115d42f1adfbc92;p=platform%2Fcore%2Fapi%2Fmaps-service.git [9.0][maps-service] Remove conditional statements for Mobile/Wearable profile Change-Id: I2cffd6cff74ebc3f187ee3362e88c888f7dfe90c --- diff --git a/include/maps_address.h b/include/maps_address.h index 33c0560..3487205 100644 --- a/include/maps_address.h +++ b/include/maps_address.h @@ -40,7 +40,7 @@ extern "C" { * @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; @@ -49,7 +49,7 @@ 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; @@ -61,7 +61,7 @@ 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 @@ -81,7 +81,7 @@ int maps_address_create(maps_address_h *address) TIZEN_DEPRECATED_API; * @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 @@ -100,7 +100,7 @@ int maps_address_destroy(maps_address_h address) TIZEN_DEPRECATED_API; * @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 @@ -124,7 +124,7 @@ int maps_address_clone(const maps_address_h origin, maps_address_h *cloned) TIZE * @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 @@ -144,7 +144,7 @@ int maps_address_get_building_number(const maps_address_h address, char **buildi * @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 @@ -164,7 +164,7 @@ int maps_address_get_street(const maps_address_h address, char **street) TIZEN_D * @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 @@ -184,7 +184,7 @@ int maps_address_get_district(const maps_address_h address, char **district); * @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 @@ -204,7 +204,7 @@ int maps_address_get_city(const maps_address_h address, char **city) TIZEN_DEPRE * @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 @@ -224,7 +224,7 @@ int maps_address_get_state(const maps_address_h address, char **state) TIZEN_DEP * @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 @@ -244,7 +244,7 @@ int maps_address_get_country(const maps_address_h address, char **country) TIZEN * @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 @@ -264,7 +264,7 @@ int maps_address_get_country_code(const maps_address_h address, char **country_c * @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 @@ -284,7 +284,7 @@ int maps_address_get_county(const maps_address_h address, char **county) TIZEN_D * @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 @@ -304,7 +304,7 @@ int maps_address_get_postal_code(const maps_address_h address, char **postal_cod * @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 @@ -327,7 +327,7 @@ int maps_address_get_freetext(const maps_address_h address, char **freetext) TIZ * @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, @@ -345,7 +345,7 @@ int maps_address_set_building_number(maps_address_h address, const char *buildin * @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, @@ -364,7 +364,7 @@ int maps_address_set_street(maps_address_h address, const char *street) TIZEN_DE * @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, @@ -383,7 +383,7 @@ int maps_address_set_district(maps_address_h address, const char *district) TIZE * @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, @@ -402,7 +402,7 @@ int maps_address_set_city(maps_address_h address, const char *city) TIZEN_DEPREC * @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, @@ -421,7 +421,7 @@ int maps_address_set_state(maps_address_h address, const char *state) TIZEN_DEPR * @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, @@ -440,7 +440,7 @@ int maps_address_set_country(maps_address_h address, const char *country) TIZEN_ * @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, @@ -459,7 +459,7 @@ int maps_address_set_country_code(maps_address_h address, const char *country_co * @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, @@ -478,7 +478,7 @@ int maps_address_set_county(maps_address_h address, const char *county) TIZEN_DE * @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, @@ -497,7 +497,7 @@ int maps_address_set_postal_code(maps_address_h address, const char *postal_code * @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, @@ -515,7 +515,7 @@ int maps_address_set_freetext(maps_address_h address, const char *freetext) TIZE /** * @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 @@ -531,7 +531,7 @@ int maps_address_list_create(maps_address_list_h *address_list) TIZEN_DEPRECATED /** * @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 @@ -551,7 +551,7 @@ int maps_address_list_append(maps_address_list_h address_list, maps_address_h ad /** * @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 @@ -571,7 +571,7 @@ int maps_address_list_remove(maps_address_list_h address_list, maps_address_h ad /** * @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, @@ -588,7 +588,7 @@ int maps_address_list_get_length(maps_address_list_h address_list, int *length) /** * @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 @@ -603,7 +603,7 @@ typedef bool (*maps_address_cb)(int index, maps_address_h address, void *user_da /** * @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 @@ -622,7 +622,7 @@ int maps_address_list_foreach(maps_address_list_h address_list, maps_address_cb /** * @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 diff --git a/include/maps_area.h b/include/maps_area.h index 96c9d66..3dd7971 100644 --- a/include/maps_area.h +++ b/include/maps_area.h @@ -44,7 +44,7 @@ extern "C" { * @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() @@ -57,7 +57,7 @@ typedef void *maps_area_h; * @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. */ @@ -70,7 +70,7 @@ typedef enum { * @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 { @@ -83,7 +83,7 @@ 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 { @@ -96,7 +96,7 @@ 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. */ @@ -113,7 +113,7 @@ typedef struct _maps_area_s { * @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(). @@ -140,7 +140,7 @@ int maps_area_create_rectangle(const maps_coordinates_h top_left, const maps_coo * @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 @@ -170,7 +170,7 @@ int maps_area_create_circle(const maps_coordinates_h center, const double radius * @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 @@ -189,7 +189,7 @@ int maps_area_destroy(maps_area_h area) TIZEN_DEPRECATED_API; * @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 diff --git a/include/maps_coordinates.h b/include/maps_coordinates.h index a85b1db..bfd7726 100644 --- a/include/maps_coordinates.h +++ b/include/maps_coordinates.h @@ -42,7 +42,7 @@ extern "C" { * @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(). */ @@ -55,7 +55,7 @@ typedef void *maps_coordinates_h; * @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. @@ -71,7 +71,7 @@ typedef struct _maps_coordinates_s { * @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; @@ -84,7 +84,7 @@ 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) @@ -106,7 +106,7 @@ int maps_coordinates_create(const double latitude, const double longitude, maps_ * @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 @@ -124,7 +124,7 @@ int maps_coordinates_destroy(maps_coordinates_h coordinates) TIZEN_DEPRECATED_AP * @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 @@ -148,7 +148,7 @@ int maps_coordinates_clone(const maps_coordinates_h origin, maps_coordinates_h * * @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, @@ -167,7 +167,7 @@ int maps_coordinates_get_latitude(const maps_coordinates_h coordinates, double * * @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, @@ -186,7 +186,7 @@ int maps_coordinates_get_longitude(const maps_coordinates_h coordinates, double * @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 @@ -209,7 +209,7 @@ int maps_coordinates_get_latitude_longitude(const maps_coordinates_h coordinates * @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, @@ -228,7 +228,7 @@ int maps_coordinates_set_latitude(maps_coordinates_h coordinates, const double l * @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, @@ -247,7 +247,7 @@ int maps_coordinates_set_longitude(maps_coordinates_h coordinates, const double * @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) @@ -266,7 +266,7 @@ int maps_coordinates_set_latitude_longitude(maps_coordinates_h coordinates, cons /** * @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 @@ -282,7 +282,7 @@ int maps_coordinates_list_create(maps_coordinates_list_h *coordinates_list) TIZE /** * @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 @@ -295,7 +295,7 @@ int maps_coordinates_list_destroy(maps_coordinates_list_h coordinates_list) TIZE /** * @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, @@ -313,7 +313,7 @@ int maps_coordinates_list_append(maps_coordinates_list_h coordinates_list, maps_ /** * @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, @@ -330,7 +330,7 @@ int maps_coordinates_list_remove(maps_coordinates_list_h coordinates_list, maps_ /** * @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, @@ -347,7 +347,7 @@ int maps_coordinates_list_get_length(maps_coordinates_list_h coordinates_list, i /** * @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 @@ -360,7 +360,7 @@ typedef bool (*maps_coordinates_cb) (int index, maps_coordinates_h coordinates, /** * @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 diff --git a/include/maps_error.h b/include/maps_error.h index 5beac96..5dd2f4e 100644 --- a/include/maps_error.h +++ b/include/maps_error.h @@ -40,7 +40,7 @@ extern "C" { /** * @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 */ @@ -79,7 +79,7 @@ typedef enum _maps_error_e { 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 */ diff --git a/include/maps_place.h b/include/maps_place.h index 81c0990..9b5f8a2 100644 --- a/include/maps_place.h +++ b/include/maps_place.h @@ -52,7 +52,7 @@ extern "C" { * @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() @@ -65,7 +65,7 @@ typedef void *maps_place_h; * @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() */ @@ -79,7 +79,7 @@ typedef void *maps_place_list_h; * @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 @@ -98,7 +98,7 @@ typedef bool(*maps_place_properties_cb) (int index, int total, char *key, void * * @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 @@ -118,7 +118,7 @@ typedef bool(*maps_place_categories_cb) (int index, int total, maps_place_catego * @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 @@ -138,7 +138,7 @@ typedef bool(*maps_place_attributes_cb) (int index, int total, maps_place_attrib * @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 @@ -158,7 +158,7 @@ typedef bool(*maps_place_contacts_cb) (int index, int total, maps_place_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 @@ -178,7 +178,7 @@ typedef bool(*maps_place_editorials_cb) (int index, int total, maps_place_editor * @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 @@ -198,7 +198,7 @@ typedef bool(*maps_place_images_cb) (int index, int total, maps_place_image_h im * @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 @@ -218,7 +218,7 @@ typedef bool(*maps_place_reviews_cb) (int index, int total, maps_place_review_h * @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() @@ -244,7 +244,7 @@ typedef bool(*maps_place_cb) (int index, maps_place_h place, void *user_data) TI * @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 @@ -260,7 +260,7 @@ int maps_place_destroy(maps_place_h place) TIZEN_DEPRECATED_API; * @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 @@ -282,7 +282,7 @@ int maps_place_clone(const maps_place_h origin, maps_place_h *cloned) TIZEN_DEPR * @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 @@ -299,7 +299,7 @@ int maps_place_get_id(const maps_place_h place, char **id) TIZEN_DEPRECATED_API; * @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 @@ -316,7 +316,7 @@ int maps_place_get_name(const maps_place_h place, char **name) TIZEN_DEPRECATED_ * @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 @@ -333,7 +333,7 @@ int maps_place_get_uri(const maps_place_h place, char **uri) TIZEN_DEPRECATED_AP * @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 @@ -350,7 +350,7 @@ int maps_place_get_location(const maps_place_h place, maps_coordinates_h *locati * @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, @@ -366,7 +366,7 @@ int maps_place_get_distance(const maps_place_h place, int *distance) TIZEN_DEPRE * @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 @@ -382,7 +382,7 @@ int maps_place_get_address(const maps_place_h place, maps_address_h *address) TI * @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 @@ -399,7 +399,7 @@ int maps_place_get_rating(const maps_place_h place, maps_place_rating_h *rating) * @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 @@ -420,7 +420,7 @@ int maps_place_foreach_property(const maps_place_h place, maps_place_properties_ * @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 @@ -441,7 +441,7 @@ int maps_place_foreach_category(const maps_place_h place, maps_place_categories_ * @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 @@ -462,7 +462,7 @@ int maps_place_foreach_attribute(const maps_place_h place, maps_place_attributes * @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 @@ -483,7 +483,7 @@ int maps_place_foreach_contact(const maps_place_h place, maps_place_contacts_cb * @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 @@ -504,7 +504,7 @@ int maps_place_foreach_editorial(const maps_place_h place, maps_place_editorials * @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 @@ -525,7 +525,7 @@ int maps_place_foreach_image(const maps_place_h place, maps_place_images_cb call * @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 @@ -546,7 +546,7 @@ int maps_place_foreach_review(const maps_place_h place, maps_place_reviews_cb ca * @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 @@ -563,7 +563,7 @@ int maps_place_get_supplier_link(const maps_place_h place, maps_place_link_objec * @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 @@ -580,7 +580,7 @@ int maps_place_get_related_link(const maps_place_h place, maps_place_link_object * @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 @@ -602,7 +602,7 @@ int maps_place_list_foreach(const maps_place_list_h place_list, maps_place_cb ca /** * @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 diff --git a/include/maps_place_attribute.h b/include/maps_place_attribute.h index d1be1f4..1b98821 100644 --- a/include/maps_place_attribute.h +++ b/include/maps_place_attribute.h @@ -40,7 +40,7 @@ extern "C" { * @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() @@ -56,7 +56,7 @@ typedef void *maps_place_attribute_h; * @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 @@ -72,7 +72,7 @@ int maps_place_attribute_destroy(maps_place_attribute_h attribute) TIZEN_DEPRECA * @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 @@ -94,7 +94,7 @@ int maps_place_attribute_clone(const maps_place_attribute_h origin, maps_place_a * @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 @@ -111,7 +111,7 @@ int maps_place_attribute_get_id(const maps_place_attribute_h attribute, char **i * @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 @@ -128,7 +128,7 @@ int maps_place_attribute_get_label(const maps_place_attribute_h attribute, char * @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 diff --git a/include/maps_place_category.h b/include/maps_place_category.h index 501a7f3..49d8428 100644 --- a/include/maps_place_category.h +++ b/include/maps_place_category.h @@ -40,7 +40,7 @@ extern "C" { * @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() @@ -56,7 +56,7 @@ typedef void *maps_place_category_h; * @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 @@ -76,7 +76,7 @@ int maps_place_category_create(maps_place_category_h *category) TIZEN_DEPRECATED * @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 @@ -95,7 +95,7 @@ int maps_place_category_clone(const maps_place_category_h origin, maps_place_cat * @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 @@ -114,7 +114,7 @@ int maps_place_category_destroy(maps_place_category_h category) TIZEN_DEPRECATED * @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 @@ -131,7 +131,7 @@ int maps_place_category_get_id(const maps_place_category_h category, char **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 @@ -148,7 +148,7 @@ int maps_place_category_get_name(const maps_place_category_h category, char **na * @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 @@ -165,7 +165,7 @@ int maps_place_category_get_url(const maps_place_category_h category, char **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, @@ -184,7 +184,7 @@ int maps_place_category_set_id(maps_place_category_h category, const char *id) T * @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, @@ -203,7 +203,7 @@ int maps_place_category_set_name(maps_place_category_h category, const char *nam * @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, diff --git a/include/maps_place_contact.h b/include/maps_place_contact.h index 66d9bb8..faa9a50 100644 --- a/include/maps_place_contact.h +++ b/include/maps_place_contact.h @@ -40,7 +40,7 @@ extern "C" { * @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() @@ -56,7 +56,7 @@ typedef void *maps_place_contact_h; * @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 @@ -72,7 +72,7 @@ int maps_place_contact_destroy(maps_place_contact_h contact) TIZEN_DEPRECATED_AP * @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 @@ -94,7 +94,7 @@ int maps_place_contact_clone(const maps_place_contact_h origin, maps_place_conta * @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 @@ -111,7 +111,7 @@ int maps_place_contact_get_label(const maps_place_contact_h contact, char **labe * @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 @@ -128,7 +128,7 @@ int maps_place_contact_get_type(const maps_place_contact_h contact, char **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 diff --git a/include/maps_place_editorial.h b/include/maps_place_editorial.h index 868c474..7e3dbaa 100644 --- a/include/maps_place_editorial.h +++ b/include/maps_place_editorial.h @@ -42,7 +42,7 @@ extern "C" { * @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() @@ -58,7 +58,7 @@ typedef void *maps_place_editorial_h; * @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 @@ -74,7 +74,7 @@ int maps_place_editorial_destroy(maps_place_editorial_h editorial) TIZEN_DEPRECA * @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 @@ -96,7 +96,7 @@ int maps_place_editorial_clone(const maps_place_editorial_h origin, maps_place_e * @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 @@ -113,7 +113,7 @@ int maps_place_editorial_get_description(const maps_place_editorial_h editorial, * @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 @@ -130,7 +130,7 @@ int maps_place_editorial_get_language(const maps_place_editorial_h editorial, ch * @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 diff --git a/include/maps_place_filter.h b/include/maps_place_filter.h index 13164c4..18a2626 100644 --- a/include/maps_place_filter.h +++ b/include/maps_place_filter.h @@ -43,7 +43,7 @@ extern "C" { * @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() @@ -59,7 +59,7 @@ typedef void *maps_place_filter_h; * @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 @@ -81,7 +81,7 @@ typedef bool(*maps_place_filter_properties_cb) (int index, int total, char *key, * @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 @@ -101,7 +101,7 @@ int maps_place_filter_create(maps_place_filter_h *filter) TIZEN_DEPRECATED_API; * @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 @@ -120,7 +120,7 @@ int maps_place_filter_destroy(maps_place_filter_h filter) TIZEN_DEPRECATED_API; * @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 @@ -144,7 +144,7 @@ int maps_place_filter_clone(const maps_place_filter_h origin, maps_place_filter_ * @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 @@ -165,7 +165,7 @@ int maps_place_filter_get(const maps_place_filter_h filter, const char *key, cha * @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 @@ -185,7 +185,7 @@ int maps_place_filter_get_keyword(const maps_place_filter_h filter, char **keywo * @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 @@ -206,7 +206,7 @@ int maps_place_filter_get_place_name(const maps_place_filter_h filter, char **pl * @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 @@ -226,7 +226,7 @@ int maps_place_filter_get_category(const maps_place_filter_h filter, maps_place_ * @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 @@ -250,7 +250,7 @@ int maps_place_filter_foreach_property(const maps_place_filter_h filter, maps_pl * @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 @@ -273,7 +273,7 @@ int maps_place_filter_get_place_address(const maps_place_filter_h filter, char * * @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 @@ -293,7 +293,7 @@ int maps_place_filter_set(maps_place_filter_h filter, const char *key, const cha * @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, @@ -312,7 +312,7 @@ int maps_place_filter_set_keyword(maps_place_filter_h filter, const char *keywor * @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, @@ -331,7 +331,7 @@ int maps_place_filter_set_place_name(maps_place_filter_h filter, const char *pla * @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, @@ -350,7 +350,7 @@ int maps_place_filter_set_category(maps_place_filter_h filter, const maps_place_ * @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, diff --git a/include/maps_place_image.h b/include/maps_place_image.h index 2aeda1f..af782ab 100644 --- a/include/maps_place_image.h +++ b/include/maps_place_image.h @@ -43,7 +43,7 @@ extern "C" { * @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() @@ -59,7 +59,7 @@ typedef void *maps_place_image_h; * @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 @@ -75,7 +75,7 @@ int maps_place_image_destroy(maps_place_image_h image) TIZEN_DEPRECATED_API; * @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 @@ -97,7 +97,7 @@ int maps_place_image_clone(const maps_place_image_h origin, maps_place_image_h * * @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 @@ -114,7 +114,7 @@ int maps_place_image_get_id(const maps_place_image_h image, char **id) TIZEN_DEP * @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 @@ -131,7 +131,7 @@ int maps_place_image_get_url(const maps_place_image_h image, char **url) TIZEN_D * @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, @@ -147,7 +147,7 @@ int maps_place_image_get_width(const maps_place_image_h image, int *width) TIZEN * @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, @@ -163,7 +163,7 @@ int maps_place_image_get_height(const maps_place_image_h image, int *height) TIZ * @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 @@ -181,7 +181,7 @@ int maps_place_image_get_user_link(const maps_place_image_h image, maps_place_li * @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 diff --git a/include/maps_place_link_object.h b/include/maps_place_link_object.h index b3c964d..19e663d 100644 --- a/include/maps_place_link_object.h +++ b/include/maps_place_link_object.h @@ -39,7 +39,7 @@ extern "C" { * @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() @@ -55,7 +55,7 @@ typedef void *maps_place_link_object_h; * @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 @@ -71,7 +71,7 @@ int maps_place_link_object_destroy(maps_place_link_object_h link) TIZEN_DEPRECAT * @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 @@ -93,7 +93,7 @@ int maps_place_link_object_clone(const maps_place_link_object_h origin, maps_pla * @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 @@ -110,7 +110,7 @@ int maps_place_link_object_get_id(const maps_place_link_object_h link, char **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 @@ -127,7 +127,7 @@ int maps_place_link_object_get_name(const maps_place_link_object_h link, char ** * @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 @@ -144,7 +144,7 @@ int maps_place_link_object_get_string(const maps_place_link_object_h link, char * @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 diff --git a/include/maps_place_media.h b/include/maps_place_media.h index cb218d6..10901f2 100644 --- a/include/maps_place_media.h +++ b/include/maps_place_media.h @@ -42,7 +42,7 @@ extern "C" { * @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() @@ -58,7 +58,7 @@ typedef void *maps_place_media_h; * @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 @@ -74,7 +74,7 @@ int maps_place_media_destroy(maps_place_media_h media) TIZEN_DEPRECATED_API; * @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 @@ -96,7 +96,7 @@ int maps_place_media_clone(const maps_place_media_h origin, maps_place_media_h * * @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 @@ -113,7 +113,7 @@ int maps_place_media_get_attribution(const maps_place_media_h media, char **attr * @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 @@ -131,7 +131,7 @@ int maps_place_media_get_supplier(const maps_place_media_h media, maps_place_lin * @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 diff --git a/include/maps_place_review.h b/include/maps_place_review.h index 7842aaa..9f526d3 100644 --- a/include/maps_place_review.h +++ b/include/maps_place_review.h @@ -43,7 +43,7 @@ extern "C" { * @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() @@ -59,7 +59,7 @@ typedef void *maps_place_review_h; * @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 @@ -75,7 +75,7 @@ int maps_place_review_destroy(maps_place_review_h review) TIZEN_DEPRECATED_API; * @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 @@ -97,7 +97,7 @@ int maps_place_review_clone(const maps_place_review_h origin, maps_place_review_ * @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 @@ -114,7 +114,7 @@ int maps_place_review_get_date(const maps_place_review_h review, char **date) TI * @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 @@ -131,7 +131,7 @@ int maps_place_review_get_title(const maps_place_review_h review, char **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, @@ -147,7 +147,7 @@ int maps_place_review_get_rating(const maps_place_review_h review, double *ratin * @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 @@ -164,7 +164,7 @@ int maps_place_review_get_description(const maps_place_review_h review, char **d * @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 @@ -181,7 +181,7 @@ int maps_place_review_get_language(const maps_place_review_h review, char **lang * @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 @@ -199,7 +199,7 @@ int maps_place_review_get_media(const maps_place_review_h review, maps_place_med * @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 diff --git a/include/maps_place_url.h b/include/maps_place_url.h index 57cc35e..282444d 100644 --- a/include/maps_place_url.h +++ b/include/maps_place_url.h @@ -40,7 +40,7 @@ extern "C" { * @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() @@ -56,7 +56,7 @@ typedef void *maps_place_url_h; * @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 @@ -72,7 +72,7 @@ int maps_place_url_destroy(maps_place_url_h url) TIZEN_DEPRECATED_API; * @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 @@ -94,7 +94,7 @@ int maps_place_url_clone(const maps_place_url_h origin, maps_place_url_h *cloned * @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 @@ -111,7 +111,7 @@ int maps_place_url_get_path(const maps_place_url_h url, char **path) TIZEN_DEPRE * @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 diff --git a/include/maps_preference.h b/include/maps_preference.h index f8b87da..050bebc 100644 --- a/include/maps_preference.h +++ b/include/maps_preference.h @@ -57,7 +57,7 @@ extern "C" { /** * @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" @@ -65,7 +65,7 @@ extern "C" { /** * @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" @@ -73,7 +73,7 @@ extern "C" { /** * @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" @@ -81,7 +81,7 @@ extern "C" { /** * @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" @@ -89,7 +89,7 @@ extern "C" { /** * @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" @@ -97,7 +97,7 @@ extern "C" { /** * @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" @@ -108,7 +108,7 @@ extern "C" { /** * @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" @@ -116,7 +116,7 @@ extern "C" { /** * @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" @@ -124,7 +124,7 @@ extern "C" { /** * @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" @@ -132,7 +132,7 @@ extern "C" { /** * @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" @@ -140,7 +140,7 @@ extern "C" { /** * @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" @@ -148,7 +148,7 @@ extern "C" { /** * @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". */ @@ -161,7 +161,7 @@ extern "C" { * @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() @@ -173,7 +173,7 @@ typedef void *maps_preference_h; * @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 { @@ -188,7 +188,7 @@ 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 @@ -207,7 +207,7 @@ typedef enum _maps_route_optimization_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 @@ -225,7 +225,7 @@ typedef enum _maps_route_transport_mode_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 @@ -243,7 +243,7 @@ typedef enum _maps_route_feature_weight_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 @@ -270,7 +270,7 @@ typedef enum _maps_route_request_feature_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 @@ -292,7 +292,7 @@ typedef bool(*maps_preference_properties_cb) (int index, int total, char *key, c * @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 @@ -312,7 +312,7 @@ int maps_preference_create(maps_preference_h *preference) TIZEN_DEPRECATED_API; * @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 @@ -328,7 +328,7 @@ int maps_preference_destroy(maps_preference_h preference) TIZEN_DEPRECATED_API; * @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 @@ -350,7 +350,7 @@ int maps_preference_clone(const maps_preference_h origin, maps_preference_h *clo * @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, @@ -366,7 +366,7 @@ int maps_preference_get_distance_unit(const maps_preference_h preference, maps_d * @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 @@ -383,7 +383,7 @@ int maps_preference_get_language(const maps_preference_h preference, char **lang * @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, @@ -399,7 +399,7 @@ int maps_preference_get_max_results(const maps_preference_h preference, int *max * @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 @@ -416,7 +416,7 @@ int maps_preference_get_country_code(const maps_preference_h preference, char ** * @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, @@ -432,7 +432,7 @@ int maps_preference_get_route_optimization(const maps_preference_h preference, m * @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, @@ -448,7 +448,7 @@ int maps_preference_get_route_transport_mode(const maps_preference_h preference, * @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, @@ -464,7 +464,7 @@ int maps_preference_get_route_feature_weight(const maps_preference_h preference, * @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, @@ -480,7 +480,7 @@ int maps_preference_get_route_feature(const maps_preference_h preference, maps_r * @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, @@ -496,7 +496,7 @@ int maps_preference_get_route_alternatives_enabled(const maps_preference_h prefe * @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 @@ -514,7 +514,7 @@ int maps_preference_get(const maps_preference_h preference, const char *key, cha * @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 @@ -538,7 +538,7 @@ int maps_preference_foreach_property(const maps_preference_h preference, maps_pr * @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, @@ -557,7 +557,7 @@ int maps_preference_set_distance_unit(maps_preference_h preference, const maps_d * @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 @@ -581,7 +581,7 @@ int maps_preference_set_language(maps_preference_h preference, const char *langu * @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, @@ -600,7 +600,7 @@ int maps_preference_set_max_results(maps_preference_h preference, const int max_ * @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, @@ -619,7 +619,7 @@ int maps_preference_set_country_code(maps_preference_h preference, const char *c * @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, @@ -638,7 +638,7 @@ int maps_preference_set_route_optimization(maps_preference_h preference, const m * @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, @@ -657,7 +657,7 @@ int maps_preference_set_route_transport_mode(maps_preference_h preference, const * @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, @@ -676,7 +676,7 @@ int maps_preference_set_route_feature_weight(maps_preference_h preference, const * @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, @@ -695,7 +695,7 @@ int maps_preference_set_route_feature(maps_preference_h preference, const maps_r * @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, @@ -714,7 +714,7 @@ int maps_preference_set_route_alternatives_enabled(maps_preference_h preference, * @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 diff --git a/include/maps_route.h b/include/maps_route.h index 06ed863..929638a 100644 --- a/include/maps_route.h +++ b/include/maps_route.h @@ -46,7 +46,7 @@ extern "C" { * @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() @@ -62,7 +62,7 @@ typedef void *maps_route_h; * @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 @@ -82,7 +82,7 @@ typedef bool(*maps_route_path_cb) (int index, int total, maps_coordinates_h coor * @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 @@ -102,7 +102,7 @@ typedef bool(*maps_route_segment_cb) (int index, int total, maps_route_segment_h * @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 @@ -125,7 +125,7 @@ typedef bool(*maps_route_properties_cb) (int index, int total, char *key, void * * @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 @@ -141,7 +141,7 @@ int maps_route_destroy(maps_route_h route) TIZEN_DEPRECATED_API; * @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 @@ -163,7 +163,7 @@ int maps_route_clone(const maps_route_h origin, maps_route_h *cloned) TIZEN_DEPR * @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 @@ -180,7 +180,7 @@ int maps_route_get_route_id(const maps_route_h route, char **route_id) TIZEN_DEP * @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 @@ -199,7 +199,7 @@ int maps_route_get_origin(const maps_route_h route, maps_coordinates_h *origin) * @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 @@ -218,7 +218,7 @@ int maps_route_get_destination(const maps_route_h route, maps_coordinates_h *des * @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 @@ -236,7 +236,7 @@ int maps_route_get_bounding_box(const maps_route_h route, maps_area_h *bounding_ * @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, @@ -253,7 +253,7 @@ int maps_route_get_transport_mode(const maps_route_h route, maps_route_transport * @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, @@ -270,7 +270,7 @@ int maps_route_get_total_distance(const maps_route_h route, double *total_distan * @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, @@ -287,7 +287,7 @@ int maps_route_get_total_duration(const maps_route_h route, long *total_duration * @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, @@ -304,7 +304,7 @@ int maps_route_get_distance_unit(const maps_route_h route, maps_distance_unit_e * @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 @@ -325,7 +325,7 @@ int maps_route_foreach_property(const maps_route_h route, maps_route_properties_ * @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 @@ -346,7 +346,7 @@ int maps_route_foreach_path(const maps_route_h route, maps_route_path_cb callbac * @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 diff --git a/include/maps_route_maneuver.h b/include/maps_route_maneuver.h index fc47d45..1b9361b 100644 --- a/include/maps_route_maneuver.h +++ b/include/maps_route_maneuver.h @@ -42,7 +42,7 @@ extern "C" { * @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() @@ -54,7 +54,7 @@ typedef void *maps_route_maneuver_h; /** * @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 */ @@ -72,7 +72,7 @@ typedef enum { /** * @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. */ @@ -100,7 +100,7 @@ typedef enum { * @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 @@ -116,7 +116,7 @@ int maps_route_maneuver_destroy(maps_route_maneuver_h maneuver) TIZEN_DEPRECATED * @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 @@ -138,7 +138,7 @@ int maps_route_maneuver_clone(const maps_route_maneuver_h origin, maps_route_man * @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, @@ -155,7 +155,7 @@ int maps_route_maneuver_get_direction_id(const maps_route_maneuver_h maneuver, m * @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, @@ -172,7 +172,7 @@ int maps_route_maneuver_get_turn_type(const maps_route_maneuver_h maneuver, maps * @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 @@ -190,7 +190,7 @@ int maps_route_maneuver_get_position(const maps_route_maneuver_h maneuver, maps_ * @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 @@ -207,7 +207,7 @@ int maps_route_maneuver_get_road_name(const maps_route_maneuver_h maneuver, char * @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 @@ -224,7 +224,7 @@ int maps_route_maneuver_get_instruction_text(const maps_route_maneuver_h maneuve * @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 @@ -241,7 +241,7 @@ int maps_route_maneuver_get_locale(const maps_route_maneuver_h maneuver, char ** * @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, @@ -257,7 +257,7 @@ int maps_route_maneuver_get_time_to_next_instruction(const maps_route_maneuver_h * @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, diff --git a/include/maps_route_segment.h b/include/maps_route_segment.h index 90be6c5..8064f5e 100644 --- a/include/maps_route_segment.h +++ b/include/maps_route_segment.h @@ -46,7 +46,7 @@ extern "C" { * @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() @@ -59,7 +59,7 @@ typedef void *maps_route_segment_h; * @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 @@ -79,7 +79,7 @@ typedef bool(*maps_route_segment_path_cb) (int index, int total, maps_coordinate * @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 @@ -102,7 +102,7 @@ typedef bool(*maps_route_segment_maneuver_cb) (int index, int total, maps_route_ * @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 @@ -118,7 +118,7 @@ int maps_route_segment_destroy(maps_route_segment_h segment) TIZEN_DEPRECATED_AP * @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 @@ -140,7 +140,7 @@ int maps_route_segment_clone(const maps_route_segment_h origin, maps_route_segme * @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 @@ -158,7 +158,7 @@ int maps_route_segment_get_origin(const maps_route_segment_h segment, maps_coord * @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 @@ -176,7 +176,7 @@ int maps_route_segment_get_destination(const maps_route_segment_h segment, maps_ * @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 @@ -194,7 +194,7 @@ int maps_route_segment_get_bounding_box(const maps_route_segment_h segment, maps * @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, @@ -210,7 +210,7 @@ int maps_route_segment_get_distance(const maps_route_segment_h segment, double * * @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, @@ -226,7 +226,7 @@ int maps_route_segment_get_duration(const maps_route_segment_h segment, long *du * @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 @@ -247,7 +247,7 @@ int maps_route_segment_foreach_path(const maps_route_segment_h segment, maps_rou * @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 diff --git a/include/maps_service.h b/include/maps_service.h index 8e6fcec..245d63f 100644 --- a/include/maps_service.h +++ b/include/maps_service.h @@ -61,7 +61,7 @@ extern "C" { /** * @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 */ @@ -74,19 +74,19 @@ typedef enum _maps_service_e { 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 */ @@ -103,10 +103,10 @@ typedef enum _maps_service_data_e { 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; @@ -114,7 +114,7 @@ typedef enum _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() @@ -131,7 +131,7 @@ typedef bool(*maps_service_provider_info_cb) (char *maps_provider, void *user_da * @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, @@ -151,7 +151,7 @@ int maps_service_foreach_provider(maps_service_provider_info_cb callback, void * * @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() @@ -170,7 +170,7 @@ typedef void(*maps_service_request_user_consent_cb) (bool consented, const char * 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(). @@ -197,7 +197,7 @@ int maps_service_request_user_consent(const char *maps_provider, maps_service_re * @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 @@ -241,7 +241,7 @@ int maps_service_create(const char *maps_provider, maps_service_h *maps) TIZEN_D * @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 @@ -262,7 +262,7 @@ int maps_service_destroy(maps_service_h maps) TIZEN_DEPRECATED_API; * @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 * https://developer.here.com/, @@ -288,7 +288,7 @@ int maps_service_set_provider_key(maps_service_h maps, const char *provider_key) * @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 @@ -309,7 +309,7 @@ int maps_service_get_provider_key(const maps_service_h maps, char **provider_key * @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, @@ -330,7 +330,7 @@ int maps_service_set_preference(maps_service_h maps, maps_preference_h preferenc * @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 @@ -351,7 +351,7 @@ int maps_service_get_preference(maps_service_h maps, maps_preference_h *preferen * @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 @@ -371,7 +371,7 @@ int maps_service_provider_is_service_supported(const maps_service_h maps, maps_s * @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 @@ -397,7 +397,7 @@ int maps_service_provider_is_data_supported(const maps_service_h maps, maps_serv * @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 @@ -453,7 +453,6 @@ int maps_service_cancel_request(const maps_service_h maps, int request_id) TIZEN /** * @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 @@ -464,7 +463,6 @@ int maps_service_cancel_request(const maps_service_h maps, int request_id) TIZEN * 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 * Feature Element. - * @endif * @addtogroup CAPI_MAPS_GEOCODER_MODULE * @{ * @brief This provides APIs for Geocoder Service. @@ -483,7 +481,7 @@ int maps_service_cancel_request(const maps_service_h maps, int request_id) TIZEN * @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 @@ -511,7 +509,7 @@ typedef bool(*maps_service_geocode_cb) (maps_error_e result, int request_id, int * @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 @@ -536,7 +534,7 @@ typedef void (*maps_service_reverse_geocode_cb) (maps_error_e result, int reques * @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 @@ -580,7 +578,7 @@ int maps_service_geocode(const maps_service_h maps, const char *address, const m * @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 @@ -628,7 +626,7 @@ int maps_service_geocode_inside_area(const maps_service_h maps, const char *addr * @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 @@ -673,7 +671,7 @@ int maps_service_geocode_by_structured_address(const maps_service_h maps, const * @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 @@ -718,7 +716,7 @@ int maps_service_reverse_geocode(const maps_service_h maps, double latitude, dou * @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 @@ -745,7 +743,7 @@ typedef bool (*maps_service_multi_reverse_geocode_cb) (maps_error_e result, int * @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 @@ -795,7 +793,6 @@ int maps_service_multi_reverse_geocode(const maps_service_h maps, maps_coordinat /** * @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 @@ -806,7 +803,6 @@ int maps_service_multi_reverse_geocode(const maps_service_h maps, maps_coordinat * 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 * Feature Element. - * @endif * @addtogroup CAPI_MAPS_PLACE_MODULE * @{ * @brief This provides APIs for Place Service. @@ -820,7 +816,7 @@ int maps_service_multi_reverse_geocode(const maps_service_h maps, maps_coordinat * @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 @@ -849,7 +845,7 @@ typedef bool(*maps_service_search_place_cb) (maps_error_e error, int request_id, * @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 @@ -873,7 +869,7 @@ typedef void(*maps_service_search_place_list_cb) (maps_error_e error, int reques * @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 @@ -895,7 +891,7 @@ typedef void(*maps_service_get_place_details_cb) (maps_error_e error, int reques * @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 @@ -947,7 +943,7 @@ int maps_service_search_place(const maps_service_h maps, const maps_coordinates_ * @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 @@ -999,7 +995,7 @@ int maps_service_search_place_by_area(const maps_service_h maps, const maps_area * @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 @@ -1052,7 +1048,7 @@ int maps_service_search_place_by_address(const maps_service_h maps, const char * * @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 @@ -1097,7 +1093,7 @@ int maps_service_search_place_list(const maps_service_h maps, const maps_area_h * @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 @@ -1150,7 +1146,6 @@ int maps_service_get_place_details(const maps_service_h maps, const char *uri, m /** * @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 @@ -1161,7 +1156,6 @@ int maps_service_get_place_details(const maps_service_h maps, const char *uri, m * 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 * Feature Element. - * @endif * @addtogroup CAPI_MAPS_ROUTE_MODULE * @{ * @brief This provides APIs for Route Service. @@ -1176,7 +1170,7 @@ int maps_service_get_place_details(const maps_service_h maps, const char *uri, m * @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 @@ -1204,7 +1198,7 @@ typedef bool(*maps_service_search_route_cb) (maps_error_e error, int request_id, * @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 @@ -1251,7 +1245,7 @@ int maps_service_search_route(const maps_service_h maps, const maps_coordinates_ * @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 diff --git a/include/maps_types.h b/include/maps_types.h index 8042770..91bd9b0 100644 --- a/include/maps_types.h +++ b/include/maps_types.h @@ -44,7 +44,7 @@ extern "C" { * @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() */ @@ -55,7 +55,7 @@ typedef void *maps_service_h; * @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() diff --git a/include/maps_view.h b/include/maps_view.h index 8937688..92b5ac3 100644 --- a/include/maps_view.h +++ b/include/maps_view.h @@ -28,7 +28,6 @@ /** * @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 @@ -39,7 +38,6 @@ * 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 * Feature Element. - * @endif * @file maps_view.h * @brief This file contains the top level functions of View API. * @addtogroup CAPI_MAPS_VIEW_MODULE @@ -65,7 +63,7 @@ extern "C" { /** * @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 */ @@ -79,7 +77,7 @@ typedef enum _maps_view_type_e { * @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 @@ -97,7 +95,7 @@ typedef bool(*maps_view_object_cb) (int index, int total, maps_view_object_h obj * @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 @@ -130,7 +128,7 @@ typedef void(*maps_view_on_event_cb) (maps_view_event_type_e type, maps_view_eve * 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(). @@ -162,7 +160,7 @@ int maps_view_create(maps_service_h maps, Evas_Object *obj, maps_view_h *view) T * @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 @@ -185,7 +183,7 @@ int maps_view_destroy(maps_view_h view) TIZEN_DEPRECATED_API; * @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 @@ -215,7 +213,7 @@ int maps_view_set_center(maps_view_h view, maps_coordinates_h coordinates) TIZEN * @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 @@ -244,7 +242,7 @@ int maps_view_get_center(const maps_view_h view, maps_coordinates_h *coordinates * 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 @@ -273,7 +271,7 @@ int maps_view_set_zoom_level(maps_view_h view, int level) TIZEN_DEPRECATED_API; * @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, @@ -294,7 +292,7 @@ int maps_view_get_zoom_level(const maps_view_h view, int *level) TIZEN_DEPRECATE * @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 @@ -321,7 +319,7 @@ int maps_view_set_min_zoom_level(maps_view_h view, int level) TIZEN_DEPRECATED_A * @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, @@ -343,7 +341,7 @@ int maps_view_get_min_zoom_level(const maps_view_h view, int *min_zoom_level) TI * @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 @@ -370,7 +368,7 @@ int maps_view_set_max_zoom_level(maps_view_h view, int level) TIZEN_DEPRECATED_A * @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, @@ -394,7 +392,7 @@ int maps_view_get_max_zoom_level(const maps_view_h view, int *max_zoom_level) TI * @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 @@ -421,7 +419,7 @@ int maps_view_set_orientation(maps_view_h view, double angle) TIZEN_DEPRECATED_A * @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, @@ -444,7 +442,7 @@ int maps_view_get_orientation(const maps_view_h view, double *rotation_angle) TI * @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(). @@ -474,7 +472,7 @@ int maps_view_screen_to_geolocation(maps_view_h view, int x, int y, maps_coordin * @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 @@ -506,7 +504,7 @@ int maps_view_geolocation_to_screen(maps_view_h view, const maps_coordinates_h c * @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 @@ -535,7 +533,7 @@ int maps_view_set_type(maps_view_h view, maps_view_type_e type) TIZEN_DEPRECATED * @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, @@ -556,7 +554,7 @@ int maps_view_get_type(const maps_view_h view, maps_view_type_e *type) TIZEN_DEP * @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 @@ -586,7 +584,7 @@ int maps_view_set_buildings_enabled(maps_view_h view, bool enable) TIZEN_DEPRECA * @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, @@ -606,7 +604,7 @@ int maps_view_get_buildings_enabled(const maps_view_h view, bool *enable) TIZEN_ * @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 @@ -636,7 +634,7 @@ int maps_view_set_traffic_enabled(maps_view_h view, bool enable) TIZEN_DEPRECATE * @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, @@ -656,7 +654,7 @@ int maps_view_get_traffic_enabled(const maps_view_h view, bool *enable) TIZEN_DE * @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 @@ -686,7 +684,7 @@ int maps_view_set_public_transit_enabled(maps_view_h view, bool enable) TIZEN_DE * @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, @@ -707,7 +705,7 @@ int maps_view_get_public_transit_enabled(const maps_view_h view, bool *enable) T * @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 @@ -743,7 +741,7 @@ int maps_view_set_language(maps_view_h view, const char *language) TIZEN_DEPRECA * @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 @@ -765,7 +763,7 @@ int maps_view_get_language(const maps_view_h view, char **language) TIZEN_DEPREC * @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 @@ -791,7 +789,7 @@ int maps_view_set_scalebar_enabled(maps_view_h view, bool enable) TIZEN_DEPRECAT * @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, @@ -813,7 +811,7 @@ int maps_view_get_scalebar_enabled(const maps_view_h view, bool *enabled) TIZEN_ * @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, @@ -833,7 +831,7 @@ int maps_view_get_viewport(const maps_view_h view, Evas_Object **viewport) TIZEN * @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 @@ -865,7 +863,7 @@ int maps_view_set_screen_location(maps_view_h view, int x, int y, int width, int * @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 @@ -890,7 +888,7 @@ int maps_view_get_screen_location(const maps_view_h view, int *x, int *y, int *w * @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 @@ -913,7 +911,7 @@ int maps_view_move(maps_view_h view, int x, int y) TIZEN_DEPRECATED_API; * @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 @@ -943,7 +941,7 @@ int maps_view_resize(maps_view_h view, int width, int height) TIZEN_DEPRECATED_A * @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, @@ -963,7 +961,7 @@ int maps_view_set_visibility(maps_view_h view, bool visible) TIZEN_DEPRECATED_AP * @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, @@ -986,7 +984,7 @@ int maps_view_get_visibility(const maps_view_h view, bool *visible) TIZEN_DEPREC * @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 @@ -1010,7 +1008,7 @@ int maps_view_set_event_cb(maps_view_h view, maps_view_event_type_e type, maps_v * @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, @@ -1031,7 +1029,7 @@ int maps_view_unset_event_cb(maps_view_h view, maps_view_event_type_e type) TIZE * @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 @@ -1052,7 +1050,7 @@ int maps_view_set_gesture_enabled(maps_view_h view, maps_view_gesture_e gesture, * @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 @@ -1078,7 +1076,7 @@ int maps_view_get_gesture_enabled(const maps_view_h view, maps_view_gesture_e ge * @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(). @@ -1108,7 +1106,7 @@ int maps_view_add_object(maps_view_h view, maps_view_object_h object) TIZEN_DEPR * @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. @@ -1134,7 +1132,7 @@ int maps_view_remove_object(maps_view_h view, maps_view_object_h object) TIZEN_D * @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. @@ -1158,7 +1156,7 @@ int maps_view_remove_all_objects(maps_view_h view) TIZEN_DEPRECATED_API; * @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 diff --git a/include/maps_view_event_data.h b/include/maps_view_event_data.h index cfd3cea..de02d85 100644 --- a/include/maps_view_event_data.h +++ b/include/maps_view_event_data.h @@ -78,7 +78,7 @@ extern "C" { * @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() @@ -91,7 +91,7 @@ typedef void *maps_view_event_data_h; * @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 @@ -110,7 +110,7 @@ typedef enum _maps_view_action_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 */ @@ -127,7 +127,7 @@ typedef enum _maps_view_gesture_e { /** * @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 */ @@ -141,7 +141,7 @@ typedef enum _maps_view_event_type_e { * @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 @@ -159,7 +159,7 @@ int maps_view_event_data_destroy(maps_view_event_data_h event) TIZEN_DEPRECATED_ * @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 @@ -181,7 +181,7 @@ int maps_view_event_data_clone(const maps_view_event_data_h origin, maps_view_ev * @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, @@ -203,7 +203,7 @@ int maps_view_event_data_get_type(const maps_view_event_data_h event, maps_view_ * @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, @@ -225,7 +225,7 @@ int maps_view_event_data_get_gesture_type(const maps_view_event_data_h event, ma * @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, @@ -247,7 +247,7 @@ int maps_view_event_data_get_action_type(const maps_view_event_data_h event, map * @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 @@ -271,7 +271,7 @@ int maps_view_event_data_get_center(const maps_view_event_data_h event, maps_coo * @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 @@ -294,7 +294,7 @@ int maps_view_event_data_get_delta(const maps_view_event_data_h event, int *delt * @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 @@ -317,7 +317,7 @@ int maps_view_event_data_get_position(const maps_view_event_data_h event, int *x * @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 @@ -341,7 +341,7 @@ int maps_view_event_data_get_coordinates(const maps_view_event_data_h event, map * @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, @@ -363,7 +363,7 @@ int maps_view_event_data_get_fingers(const maps_view_event_data_h event, int *fi * @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, @@ -385,7 +385,7 @@ int maps_view_event_data_get_zoom_factor(const maps_view_event_data_h event, dou * @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, @@ -407,7 +407,7 @@ int maps_view_event_data_get_rotation_angle(const maps_view_event_data_h event, * @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 diff --git a/include/maps_view_object.h b/include/maps_view_object.h index ec3a537..701d1da 100644 --- a/include/maps_view_object.h +++ b/include/maps_view_object.h @@ -48,7 +48,7 @@ extern "C" { * @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() @@ -64,7 +64,7 @@ typedef void *maps_view_object_h; /** * @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 */ @@ -77,7 +77,7 @@ typedef enum _maps_view_object_type_e { /** * @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 */ @@ -88,7 +88,7 @@ typedef enum _maps_view_marker_type_e { /** * @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 */ @@ -101,7 +101,7 @@ typedef enum _maps_view_overlay_type_e { * @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 @@ -121,7 +121,7 @@ typedef bool(*maps_view_object_polyline_point_cb) (int index, int total, maps_co * @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 @@ -148,7 +148,7 @@ typedef bool(*maps_view_object_polygon_point_cb) (int index, int total, maps_coo * @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 @@ -180,7 +180,7 @@ int maps_view_object_create_marker(maps_coordinates_h coordinates, const char *i * @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 @@ -212,7 +212,7 @@ int maps_view_object_create_polyline(maps_coordinates_list_h coordinates, unsign * @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 @@ -243,7 +243,7 @@ int maps_view_object_create_polygon(maps_coordinates_list_h coordinates, unsigne * @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 @@ -273,7 +273,7 @@ int maps_view_object_create_overlay(maps_coordinates_h coordinates, Evas_Object * @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 @@ -292,7 +292,7 @@ int maps_view_object_destroy(maps_view_object_h object) TIZEN_DEPRECATED_API; * @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, @@ -313,7 +313,7 @@ int maps_view_object_get_type(maps_view_object_h object, maps_view_object_type_e * @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, @@ -332,7 +332,7 @@ int maps_view_object_set_visible(maps_view_object_h object, bool visible) TIZEN_ * @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, @@ -357,7 +357,7 @@ int maps_view_object_get_visible(const maps_view_object_h object, bool *visible) * @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, @@ -381,7 +381,7 @@ int maps_view_object_polyline_set_polyline(maps_view_object_h polyline, maps_coo * @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 @@ -405,7 +405,7 @@ int maps_view_object_polyline_foreach_point(maps_view_object_h polyline, maps_co * @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 @@ -428,7 +428,7 @@ int maps_view_object_polyline_set_color(maps_view_object_h polyline, unsigned ch * @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 @@ -452,7 +452,7 @@ int maps_view_object_polyline_get_color(const maps_view_object_h polyline, unsig * @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, @@ -472,7 +472,7 @@ int maps_view_object_polyline_set_width(maps_view_object_h polyline, int width) * @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, @@ -499,7 +499,7 @@ int maps_view_object_polyline_get_width(const maps_view_object_h polyline, int * * @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, @@ -522,7 +522,7 @@ int maps_view_object_polygon_set_polygon(maps_view_object_h polygon, maps_coordi * @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 @@ -548,7 +548,7 @@ int maps_view_object_polygon_foreach_point(maps_view_object_h polygon, maps_coor * @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 @@ -570,7 +570,7 @@ int maps_view_object_polygon_set_fill_color(maps_view_object_h polygon, unsigned * @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 @@ -599,7 +599,7 @@ int maps_view_object_polygon_get_fill_color(const maps_view_object_h polygon, un * @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, @@ -621,7 +621,7 @@ int maps_view_object_marker_set_coordinates(maps_view_object_h marker, maps_coor * @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). @@ -644,7 +644,7 @@ int maps_view_object_marker_resize(maps_view_object_h marker, int width, int hei * @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 @@ -666,7 +666,7 @@ int maps_view_object_marker_set_image_file(maps_view_object_h marker, const char * @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 @@ -688,7 +688,7 @@ int maps_view_object_marker_get_image_file(const maps_view_object_h marker, char * @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 @@ -711,7 +711,7 @@ int maps_view_object_marker_get_coordinates(const maps_view_object_h marker, map * @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 @@ -732,7 +732,7 @@ int maps_view_object_marker_get_size(const maps_view_object_h marker, int *width * @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, @@ -751,7 +751,7 @@ int maps_view_object_marker_get_type(const maps_view_object_h marker, maps_view_ * @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 @@ -771,7 +771,7 @@ int maps_view_object_marker_set_z_order(maps_view_object_h marker, int 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, @@ -797,7 +797,7 @@ int maps_view_object_marker_get_z_order(const maps_view_object_h marker, int *z_ * @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 @@ -816,7 +816,7 @@ int maps_view_object_overlay_get_object(maps_view_object_h overlay, Evas_Object * @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, @@ -838,7 +838,7 @@ int maps_view_object_overlay_set_coordinates(maps_view_object_h overlay, maps_co * @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 @@ -862,7 +862,7 @@ int maps_view_object_overlay_get_coordinates(const maps_view_object_h overlay, m * @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, @@ -883,7 +883,7 @@ int maps_view_object_overlay_set_min_zoom_level(maps_view_object_h overlay, int * @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, @@ -904,7 +904,7 @@ int maps_view_object_overlay_get_min_zoom_level(const maps_view_object_h overlay * @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, @@ -925,7 +925,7 @@ int maps_view_object_overlay_set_max_zoom_level(maps_view_object_h overlay, int * @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, diff --git a/include/maps_view_snapshot.h b/include/maps_view_snapshot.h index 2eb81da..e4077b2 100644 --- a/include/maps_view_snapshot.h +++ b/include/maps_view_snapshot.h @@ -41,7 +41,7 @@ extern "C" { /** * @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 */ @@ -54,7 +54,7 @@ typedef enum _maps_view_snapshot_format_type_e { * @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