Added in API level 19

Summary: Constants | Inherited Constants | Fields | Inherited Methods

Telephony.Carriers

Kotlin |Java

public static final class Telephony.Carriers
extends Object implements BaseColumns

java.lang.Object
↳	android.provider.Telephony.Carriers

Carriers class contains information about APNs, including MMSC information.

Summary

Constants
`String`	`ALWAYS_ON` Sets whether the PDU session brought up by this APN should always be on.
`String`	`APN` APN name.
`String`	`AUTH_TYPE` Authentication type.
`String`	`BEARER` This constant was deprecated in API level 28. this column is no longer supported, use `NETWORK_TYPE_BITMASK` instead
`String`	`CARRIER_ENABLED` Is this APN enabled? Type: INTEGER (boolean)
`String`	`CARRIER_ID` A unique carrier id associated with this APN `TelephonyManager#getSimCarrierId()` In case of matching carrier information, this should be used by default instead of those fields of `MCC`, `MNC`, `NUMERIC`, `MVNO_TYPE`, `MVNO_MATCH_DATA`, etc.
`String`	`CURRENT` Is this the current APN? Type: INTEGER (boolean)
`String`	`DEFAULT_SORT_ORDER` The default sort order for this table.
`String`	`MCC` This constant was deprecated in API level 29. Use `SIM_APN_URI` to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MCC and other carrier matching information. In the future, Android will not support MCC for APN query.
`String`	`MMSC` MMSC URL.
`String`	`MMSPORT` MMS proxy port.
`String`	`MMSPROXY` MMS proxy address.
`String`	`MNC` This constant was deprecated in API level 29. Use `SIM_APN_URI` to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MNC and other carrier matching information. In the future, Android will not support MNC for APN query.
`String`	`MTU_V4` The MTU (maximum transmit unit) size of the mobile interface for IPv4 to which the APN is connected, in bytes.
`String`	`MTU_V6` The MTU (maximum transmit unit) size of the mobile interface for IPv6 to which the APN is connected, in bytes.
`String`	`MVNO_MATCH_DATA` This constant was deprecated in API level 29. Use `SIM_APN_URI` to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MVNO_MATCH_DATA and other carrier matching information. In the future, Android will not support MVNO_MATCH_DATA for APN query.
`String`	`MVNO_TYPE` This constant was deprecated in API level 29. Use `SIM_APN_URI` to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MVNO_TYPE and other carrier matching information. In the future, Android will not support MVNO_TYPE for APN query.
`String`	`NAME` Entry name.
`String`	`NETWORK_TYPE_BITMASK` Radio technology (network type) bitmask.
`String`	`NUMERIC` This constant was deprecated in API level 29. Use `SIM_APN_URI` to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify Numeric and other carrier matching information. In the future, Android will not support Numeric for APN query.
`String`	`PASSWORD` APN password.
`String`	`PORT` Proxy port.
`String`	`PROTOCOL` The protocol to use to connect to this APN.
`String`	`PROXY` Proxy address.
`String`	`ROAMING_PROTOCOL` The protocol to use to connect to this APN when roaming.
`String`	`SERVER` Server address.
`String`	`SUBSCRIPTION_ID` The subscription to which the APN belongs to Type: INTEGER (long)
`String`	`TYPE` Comma-delimited list of APN types.
`String`	`USER` APN username.
`String`	`USER_EDITABLE` `true` if the user allowed to edit this APN, `false` otherwise.
`String`	`USER_VISIBLE` `true` if this APN visible to the user, `false` otherwise.

Inherited constants

From interface android.provider.BaseColumns

`String`	`_COUNT` The count of rows in a directory.
`String`	`_ID` The unique ID for a row.

Fields
`public static final Uri`	`CONTENT_URI` The `content://` style URL for this table.
`public static final Uri`	`SIM_APN_URI` The `content://` style URL for this table.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ALWAYS_ON

Added in API level 35

public static final String ALWAYS_ON

Sets whether the PDU session brought up by this APN should always be on. See 3GPP TS 23.501 section 5.6.13

Type: INTEGER

Constant Value: "always_on"

APN

Added in API level 19

public static final String APN

APN name.

Type: TEXT

Constant Value: "apn"

AUTH_TYPE

Added in API level 19

public static final String AUTH_TYPE

Authentication type.

Type: INTEGER

Constant Value: "authtype"

BEARER

Added in API level 19
Deprecated in API level 28

public static final String BEARER

This constant was deprecated in API level 28.
this column is no longer supported, use NETWORK_TYPE_BITMASK instead

Radio Access Technology info. To check what values are allowed, refer to ServiceState. This should be spread to other technologies, but is currently only used for LTE (14) and eHRPD (13).

Type: INTEGER

Constant Value: "bearer"

CARRIER_ENABLED

Added in API level 19

public static final String CARRIER_ENABLED

Is this APN enabled?

Type: INTEGER (boolean)

Constant Value: "carrier_enabled"

CARRIER_ID

Added in API level 29

public static final String CARRIER_ID

A unique carrier id associated with this APN TelephonyManager#getSimCarrierId() In case of matching carrier information, this should be used by default instead of those fields of MCC, MNC, NUMERIC, MVNO_TYPE, MVNO_MATCH_DATA, etc.

Type: STRING

Constant Value: "carrier_id"

CURRENT

Added in API level 19

public static final String CURRENT

Is this the current APN?

Type: INTEGER (boolean)

Constant Value: "current"

DEFAULT_SORT_ORDER

Added in API level 19

public static final String DEFAULT_SORT_ORDER

The default sort order for this table.

Constant Value: "name ASC"

MCC

Added in API level 19
Deprecated in API level 29

public static final String MCC

This constant was deprecated in API level 29.
Use SIM_APN_URI to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MCC and other carrier matching information. In the future, Android will not support MCC for APN query.

Mobile Country Code (MCC).

Type: TEXT

Constant Value: "mcc"

MMSC

Added in API level 19

public static final String MMSC

MMSC URL.

Type: TEXT

Constant Value: "mmsc"

MMSPORT

Added in API level 19

public static final String MMSPORT

MMS proxy port.

Type: TEXT

Constant Value: "mmsport"

MMSPROXY

Added in API level 19

public static final String MMSPROXY

MMS proxy address.

Type: TEXT

Constant Value: "mmsproxy"

MNC

Added in API level 19
Deprecated in API level 29

public static final String MNC

This constant was deprecated in API level 29.
Use SIM_APN_URI to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MNC and other carrier matching information. In the future, Android will not support MNC for APN query.

Mobile Network Code (MNC).

Type: TEXT

Constant Value: "mnc"

MTU_V4

Added in API level 35

public static final String MTU_V4

The MTU (maximum transmit unit) size of the mobile interface for IPv4 to which the APN is connected, in bytes.

Type: INTEGER

Constant Value: "mtu_v4"

MTU_V6

Added in API level 35

public static final String MTU_V6

The MTU (maximum transmit unit) size of the mobile interface for IPv6 to which the APN is connected, in bytes.

Type: INTEGER

Constant Value: "mtu_v6"

MVNO_MATCH_DATA

Added in API level 19
Deprecated in API level 29

public static final String MVNO_MATCH_DATA

This constant was deprecated in API level 29.
Use SIM_APN_URI to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MVNO_MATCH_DATA and other carrier matching information. In the future, Android will not support MVNO_MATCH_DATA for APN query.

MVNO data. Use the following examples.

SPN: A MOBILE, BEN NL, ...
IMSI: 302720x94, 2060188, ...
GID: 4E, 33, ...

Type: TEXT

Constant Value: "mvno_match_data"

MVNO_TYPE

Added in API level 19
Deprecated in API level 29

public static final String MVNO_TYPE

This constant was deprecated in API level 29.
Use SIM_APN_URI to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify MVNO_TYPE and other carrier matching information. In the future, Android will not support MVNO_TYPE for APN query.

MVNO type: SPN (Service Provider Name), IMSI, GID (Group Identifier Level 1).

Type: TEXT

Constant Value: "mvno_type"

NAME

Added in API level 19

public static final String NAME

Entry name.

Type: TEXT

Constant Value: "name"

NETWORK_TYPE_BITMASK

Added in API level 28

public static final String NETWORK_TYPE_BITMASK

Radio technology (network type) bitmask. To check what values can be contained, refer to the NETWORK_TYPE_ constants in TelephonyManager. Bitmask for a radio tech R is (1 << (R - 1))

Type: INTEGER

Constant Value: "network_type_bitmask"

NUMERIC

Added in API level 19
Deprecated in API level 29

public static final String NUMERIC

This constant was deprecated in API level 29.
Use SIM_APN_URI to query APN instead, this API will return matching APNs based on current subscription carrier, thus no need to specify Numeric and other carrier matching information. In the future, Android will not support Numeric for APN query.

Numeric operator ID (as String). Usually MCC + MNC.

Type: TEXT

Constant Value: "numeric"

PASSWORD

Added in API level 19

public static final String PASSWORD

APN password.

Type: TEXT

Constant Value: "password"

PORT

Added in API level 19

public static final String PORT

Proxy port.

Type: TEXT

Constant Value: "port"

PROTOCOL

Added in API level 19

public static final String PROTOCOL

The protocol to use to connect to this APN. One of the PDP_type values in TS 27.007 section 10.1.1. For example: IP, IPV6, IPV4V6, or PPP.

Type: TEXT

Constant Value: "protocol"

PROXY

Added in API level 19

public static final String PROXY

Proxy address.

Type: TEXT

Constant Value: "proxy"

ROAMING_PROTOCOL

Added in API level 19

public static final String ROAMING_PROTOCOL

The protocol to use to connect to this APN when roaming. The syntax is the same as protocol.

Type: TEXT

Constant Value: "roaming_protocol"

SERVER

Added in API level 19

public static final String SERVER

Server address.

Type: TEXT

Constant Value: "server"

SUBSCRIPTION_ID

Added in API level 22

public static final String SUBSCRIPTION_ID

The subscription to which the APN belongs to

Type: INTEGER (long)

Constant Value: "sub_id"

TYPE

Added in API level 19

public static final String TYPE

Comma-delimited list of APN types.

Type: TEXT

Constant Value: "type"

USER

Added in API level 19

public static final String USER

APN username.

Type: TEXT

Constant Value: "user"

USER_EDITABLE

Added in API level 35

public static final String USER_EDITABLE

true if the user allowed to edit this APN, false otherwise.

Type: INTEGER (boolean)

Constant Value: "user_editable"

USER_VISIBLE

Added in API level 35

public static final String USER_VISIBLE

true if this APN visible to the user, false otherwise.

Type: INTEGER (boolean)

Constant Value: "user_visible"

Fields

CONTENT_URI

Added in API level 19

public static final Uri CONTENT_URI

The content:// style URL for this table. For MSIM, this will return APNs for the default subscription SubscriptionManager#getDefaultSubscriptionId(). To specify subId for MSIM, use Uri#withAppendedPath(Uri, String) to append with subscription id.

SIM_APN_URI

Added in API level 29

public static final Uri SIM_APN_URI

The content:// style URL for this table. Used for APN query based on current subscription. Instead of specifying carrier matching information in the selection, this API will return all matching APNs from current subscription carrier and queries will be applied on top of that. If there is no match for MVNO (Mobile Virtual Network Operator) APNs, return APNs from its MNO (based on mccmnc) instead. For MSIM, this will return APNs for the default subscription SubscriptionManager#getDefaultSubscriptionId(). To specify subId for MSIM, use Uri#withAppendedPath(Uri, String) to append with subscription id.