/*
 * Copyright (c) 2011 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * Licensed under the Apache License, Version 2.0 (the License);
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an AS IS BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __CAPI_TELEPHONY_NETWORK_INFO_H__
#define __CAPI_TELEPHONY_NETWORK_INFO_H__

#include "telephony_common.h"

#ifdef __cplusplus
extern "C"
{
#endif

/**
 * @file telephony_network.h
 * @brief This file contains the network APIs and related enumerations.
 */

/**
 * @addtogroup CAPI_TELEPHONY_INFORMATION_NETWORK
 * @{
 */

/**
 * @brief Enumeration for RSSI (Receive Signal Strength Indicator).
 * @details #TELEPHONY_NETWORK_RSSI_6 indicates the highest strength.
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_RSSI_0, /**< Strength 0 */
	TELEPHONY_NETWORK_RSSI_1, /**< Strength 1 */
	TELEPHONY_NETWORK_RSSI_2, /**< Strength 2 */
	TELEPHONY_NETWORK_RSSI_3, /**< Strength 3 */
	TELEPHONY_NETWORK_RSSI_4, /**< Strength 4 */
	TELEPHONY_NETWORK_RSSI_5, /**< Strength 5 */
	TELEPHONY_NETWORK_RSSI_6, /**< Strength 6 */
} telephony_network_rssi_e;

/**
 * @brief Enumeration for Network Type.
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_TYPE_UNKNOWN,		/**< Unknown */
	TELEPHONY_NETWORK_TYPE_GSM,		/**< 2G GSM network type */
	TELEPHONY_NETWORK_TYPE_GPRS,		/**< 2.5G GPRS network type */
	TELEPHONY_NETWORK_TYPE_EDGE,		/**< 2.5G EDGE network type */
	TELEPHONY_NETWORK_TYPE_UMTS,		/**< 3G UMTS network type */
	TELEPHONY_NETWORK_TYPE_HSDPA,		/**< HSDPA network type */
	TELEPHONY_NETWORK_TYPE_LTE,		/**< LTE network type */
	TELEPHONY_NETWORK_TYPE_IS95A,		/**< IS95A network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_IS95B,		/**< IS95B network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_CDMA_1X,		/**< CDMA 1x network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_EVDO_REV_0,	/**< EVDO revision 0 network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_EVDO_REV_A,	/**< EVDO revision A network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_EVDO_REV_B,	/**< EVDO revision B network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_EVDV,		/**< EVDV network type (Since: 3.0) */
	TELEPHONY_NETWORK_TYPE_EHRPD,		/**< EHRPD network type (Since: 3.0) */
} telephony_network_type_e;

/**
 * @brief Enumeration for PS Type.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_PS_TYPE_UNKNOWN,	/**< Unknown */
	TELEPHONY_NETWORK_PS_TYPE_HSDPA,	/**< HSDPA ps type */
	TELEPHONY_NETWORK_PS_TYPE_HSUPA,	/**< HSUPA ps type */
	TELEPHONY_NETWORK_PS_TYPE_HSPA,		/**< HSPA ps type */
	TELEPHONY_NETWORK_PS_TYPE_HSPAP,	/**< HSPAP ps type */
} telephony_network_ps_type_e;

/**
 * @brief Enumeration for Network Service State.
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_SERVICE_STATE_IN_SERVICE,	/**< In service */
	TELEPHONY_NETWORK_SERVICE_STATE_OUT_OF_SERVICE,	/**< Out of service */
	TELEPHONY_NETWORK_SERVICE_STATE_EMERGENCY_ONLY,	/**< Only emergency call is allowed */
} telephony_network_service_state_e;

/**
 * @brief Enumeration for Network Name Priority.
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_NAME_OPTION_UNKNOWN,	/**< Unknown */
	TELEPHONY_NETWORK_NAME_OPTION_SPN,	/**< Network name displayed by SPN */
	TELEPHONY_NETWORK_NAME_OPTION_NETWORK,	/**< Network name displayed by Network */
	TELEPHONY_NETWORK_NAME_OPTION_ANY,	/**< Network name displayed by SPN or Network */
} telephony_network_name_option_e;

/**
 * @brief Enumeration for the possible 'default' Data Subscriptions for Packet Switched(PS).
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_UNKNOWN = -1,	/**< Unknown status */
	TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM1 = 0,		/**< SIM 1 */
	TELEPHONY_NETWORK_DEFAULT_DATA_SUBS_SIM2		/**< SIM 2 */
} telephony_network_default_data_subs_e;

/**
 * @brief Enumeration for defining possible 'default' Subscriptions for Circuit Switched(CS).
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 */
typedef enum {
	TELEPHONY_NETWORK_DEFAULT_SUBS_UNKNOWN = -1,	/**< Unknown status */
	TELEPHONY_NETWORK_DEFAULT_SUBS_SIM1 = 0,	/**< SIM 1 network */
	TELEPHONY_NETWORK_DEFAULT_SUBS_SIM2		/**< SIM 2 network */
} telephony_network_default_subs_e;

/**
 * @brief Enumeration for network selection mode.
 * @since_tizen 3.0
 */
typedef enum {
	TELEPHONY_NETWORK_SELECTION_MODE_AUTOMATIC,	/**< Automatic mode */
	TELEPHONY_NETWORK_SELECTION_MODE_MANUAL		/**< Manual mode */
} telephony_network_selection_mode_e;

/**
 * @brief Gets the LAC (Location Area Code) of the current location.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in GSM / WCDMA network. @n
 *	http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0. @n
 *	http://tizen.org/privilege/telephony privilege is no longer required since 3.0.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] lac The Location Area Code, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_lac(telephony_h handle, int *lac);

/**
 * @brief Gets the cell ID of the current location.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in GSM / WCDMA / LTE network. @n
 *	http://tizen.org/privilege/location.coarse privilege is required to use this API since 3.0. @n
 *	http://tizen.org/privilege/telephony privilege is no longer required since 3.0.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] cell_id The cell identification number, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_cell_id(telephony_h handle, int *cell_id);

/**
 * @brief Gets the RSSI (Received Signal Strength Indicator).
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] rssi The Received Signal Strength Indicator \n
 *                  Higher the received number, the stronger the signal strength
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_rssi(telephony_h handle, telephony_network_rssi_e *rssi);

/**
 * @brief Gets the roaming state of the current registered network.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] status @c true if roaming,
 *                    otherwise @c false if not roaming
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_roaming_status(telephony_h handle, bool *status);

/**
 * @brief Gets the MCC (Mobile Country Code) of the current registered network.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks This API can be used in GSM / WCDMA / LTE network.
 *          You must release @c mcc using free() on success case, empty string if unknown.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] mcc The Mobile Country Code (three digits)
 *                 Mobile Country Code (MCC) identifies the country where the cell is being used
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_mcc(telephony_h handle, char **mcc);

/**
 * @brief Gets the MNC (Mobile Network Code) of the current registered network.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks This API can be used in GSM / WCDMA / LTE network.
 *          You must release @c mnc using free() on success case, empty string if unknown.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] mnc The Mobile Network Code (three digits)
 *                 The Mobile Network Code (MNC) identifies the mobile phone operator and network provider
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_mnc(telephony_h handle, char **mnc);

/**
 * @brief Gets the name of the current registered network.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks This API can be used in GSM / WCDMA / LTE network.
 *          You must release @c network_name using free() on success case.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] network_name The name of the current registered network, empty string if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_network_name(telephony_h handle, char **network_name);

/**
 * @brief Gets the network service type of the current registered network.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks This API can be used in case network is in service.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] network_type The network service type
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 */
int telephony_network_get_type(telephony_h handle, telephony_network_type_e *network_type);


/**
 * @brief Gets the packet service type of the current registered network.
 *
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks This API can be used in HSDPA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] ps_type The type of packet service
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_ps_type(telephony_h handle, telephony_network_ps_type_e *ps_type);

/**
 * @brief Gets the network name option of the current registered network.
 *
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] network_name_option The network name display option
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_network_name_option(telephony_h handle, telephony_network_name_option_e *network_name_option);


/**
 * @brief Gets the current network state of the telephony service.
 *
 * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @remarks To know the state of data network, refer connection API.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] network_service_state The current network state
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_service_state(telephony_h handle, telephony_network_service_state_e *network_service_state);


/**
 * @brief Gets the current default subscription for data service (Packet Switched).
 *
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] default_sub The current default data subscription
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_default_data_subscription(telephony_h handle, telephony_network_default_data_subs_e *default_sub);


/**
 * @brief Gets the current default subscription for voice service (Circuit Switched).
 *
 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] default_sub The current default voice subscription
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_default_subscription(telephony_h handle, telephony_network_default_subs_e *default_sub);


/**
 * @brief Gets the network selection mode.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/telephony
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] mode The network selection mode
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 */
int telephony_network_get_selection_mode(telephony_h handle, telephony_network_selection_mode_e *mode);


/**
 * @brief Gets the TAC (Tracking Area Code) of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in LTE network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] tac The Tracking Area Code, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_tac(telephony_h handle, int *tac);

/**
 * @brief Gets the system ID of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in CDMA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] sid The system ID, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_system_id(telephony_h handle, int *sid);

/**
 * @brief Gets the network ID of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in CDMA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] nid The network ID, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_network_id(telephony_h handle, int *nid);

/**
 * @brief Gets the base station ID of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in CDMA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] bs_id The base station ID, -1 if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_base_station_id(telephony_h handle, int *bs_id);

/**
 * @brief Gets the base station latitude of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in CDMA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] bs_latitude The base station latitude, 0x7FFFFFFF if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_base_station_latitude(telephony_h handle, int *bs_latitude);

/**
 * @brief Gets the base station longitude of the current location.
 *
 * @since_tizen 3.0
 * @privlevel public
 * @privilege %http://tizen.org/privilege/location.coarse
 *
 * @remarks This API can be used in CDMA network.
 *
 * @param[in] handle The handle from telephony_init()
 * @param[out] bs_longitude The base station longitude, 0x7FFFFFFF if unknown
 *
 * @return @c 0 on success,
 *         otherwise a negative error value
 *
 * @retval #TELEPHONY_ERROR_NONE              Successful
 * @retval #TELEPHONY_ERROR_INVALID_PARAMETER Invalid parameter
 * @retval #TELEPHONY_ERROR_PERMISSION_DENIED Permission denied
 * @retval #TELEPHONY_ERROR_NOT_SUPPORTED     Not supported
 * @retval #TELEPHONY_ERROR_OPERATION_FAILED  Operation failed
 *
 * @see telephony_network_get_service_state()
 * @see telephony_network_get_type()
 */
int telephony_network_get_base_station_longitude(telephony_h handle, int *bs_longitude);

/**
 * @}
 */

#ifdef __cplusplus
}
#endif

#endif /* __CAPI_TELEPHONY_NETWORK_INFO_H__ */
