Added in API level 29

EmergencyNumber

class EmergencyNumber : Parcelable, Comparable<EmergencyNumber!>
kotlin.Any
   ↳ android.telephony.emergency.EmergencyNumber

A parcelable class that wraps and retrieves the information of number, service category(s) and country code for a specific emergency number.

Summary

Constants
static Int

Indicates the radio or IMS implementation must handle the call through emergency routing.

static Int

Indicates the radio or IMS implementation must handle the call through normal call routing.

static Int

Indicated the framework does not know whether an emergency call should be placed using emergency or normal call routing.

static Int

Bit-field which indicates the number is from the platform-maintained database.

static Int

Bit-field which indicates the number is available as default.

static Int

Bit-field which indicates the number is from the modem config.

static Int

Bit-field which indicates the number is from the network signaling.

static Int

Bit-field which indicates the number is from the sim.

static Int

Bit-field that indicates Emergency Service Category for Automatically Initiated eCall (AIeC) Reference: 3gpp 22.

static Int

Bit-field that indicates Emergency Service Category for Ambulance.

static Int

Bit-field that indicates Emergency Service Category for Fire Brigade.

static Int

Bit-field that indicates Emergency Service Category for Marine Guard.

static Int

Bit-field that indicates Emergency Service Category for Manually Initiated eCall (MIeC) Reference: 3gpp 22.

static Int

Bit-field that indicates Emergency Service Category for Mountain Rescue.

static Int

Bit-field that indicates Emergency Service Category for Police.

static Int

Emergency Service Category UNSPECIFIED (General emergency call, all categories) bit-field indicates that no specific services are associated with this emergency number; if the emergency number is specified, it has one or more defined emergency service categories.

Inherited constants
Public methods
Int

Compare the display priority for this emergency number and the supplied emergency number.

Int

Boolean
equals(other: Any?)

String

Get the country code string (lowercase character) in ISO 3166 format of the emergency number.

Int

Returns the emergency call routing information.

MutableList<Int!>

Returns a list of sources of the emergency number.

MutableList<Int!>

Returns the emergency service categories of the emergency number.

MutableList<String!>

Returns the list of emergency Uniform Resources Names (URN) of the emergency number.

String

Get the Mobile Network Code of the emergency number.

String

Get the dialing number of the emergency number.

Int

Boolean
isFromSources(sources: Int)

Checks if the emergency number is from the specified emergency number source(s).

Boolean

Checks if the emergency number is in the supplied emergency service category(s).

String

Unit
writeToParcel(dest: Parcel, flags: Int)

Properties
static Parcelable.Creator<EmergencyNumber!>

Constants

EMERGENCY_CALL_ROUTING_EMERGENCY

Added in API level 29
static val EMERGENCY_CALL_ROUTING_EMERGENCY: Int

Indicates the radio or IMS implementation must handle the call through emergency routing.

Value: 1

EMERGENCY_CALL_ROUTING_NORMAL

Added in API level 29
static val EMERGENCY_CALL_ROUTING_NORMAL: Int

Indicates the radio or IMS implementation must handle the call through normal call routing.

Value: 2

EMERGENCY_CALL_ROUTING_UNKNOWN

Added in API level 29
static val EMERGENCY_CALL_ROUTING_UNKNOWN: Int

Indicated the framework does not know whether an emergency call should be placed using emergency or normal call routing. This means the underlying radio or IMS implementation is free to determine for itself how to route the call.

Value: 0

EMERGENCY_NUMBER_SOURCE_DATABASE

Added in API level 29
static val EMERGENCY_NUMBER_SOURCE_DATABASE: Int

Bit-field which indicates the number is from the platform-maintained database.

Value: 16

EMERGENCY_NUMBER_SOURCE_DEFAULT

Added in API level 29
static val EMERGENCY_NUMBER_SOURCE_DEFAULT: Int

Bit-field which indicates the number is available as default. 112, 911 must always be available; additionally, 000, 08, 110, 999, 118 and 119 must be available when sim is not present. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 8

EMERGENCY_NUMBER_SOURCE_MODEM_CONFIG

Added in API level 29
static val EMERGENCY_NUMBER_SOURCE_MODEM_CONFIG: Int

Bit-field which indicates the number is from the modem config.

Value: 4

EMERGENCY_NUMBER_SOURCE_NETWORK_SIGNALING

Added in API level 29
static val EMERGENCY_NUMBER_SOURCE_NETWORK_SIGNALING: Int

Bit-field which indicates the number is from the network signaling. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 1

EMERGENCY_NUMBER_SOURCE_SIM

Added in API level 29
static val EMERGENCY_NUMBER_SOURCE_SIM: Int

Bit-field which indicates the number is from the sim. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 2

EMERGENCY_SERVICE_CATEGORY_AIEC

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_AIEC: Int

Bit-field that indicates Emergency Service Category for Automatically Initiated eCall (AIeC) Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 64

EMERGENCY_SERVICE_CATEGORY_AMBULANCE

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_AMBULANCE: Int

Bit-field that indicates Emergency Service Category for Ambulance. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 2

EMERGENCY_SERVICE_CATEGORY_FIRE_BRIGADE

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_FIRE_BRIGADE: Int

Bit-field that indicates Emergency Service Category for Fire Brigade. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 4

EMERGENCY_SERVICE_CATEGORY_MARINE_GUARD

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_MARINE_GUARD: Int

Bit-field that indicates Emergency Service Category for Marine Guard. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 8

EMERGENCY_SERVICE_CATEGORY_MIEC

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_MIEC: Int

Bit-field that indicates Emergency Service Category for Manually Initiated eCall (MIeC) Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 32

EMERGENCY_SERVICE_CATEGORY_MOUNTAIN_RESCUE

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_MOUNTAIN_RESCUE: Int

Bit-field that indicates Emergency Service Category for Mountain Rescue. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 16

EMERGENCY_SERVICE_CATEGORY_POLICE

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_POLICE: Int

Bit-field that indicates Emergency Service Category for Police. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 1

EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED

Added in API level 29
static val EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED: Int

Emergency Service Category UNSPECIFIED (General emergency call, all categories) bit-field indicates that no specific services are associated with this emergency number; if the emergency number is specified, it has one or more defined emergency service categories. Reference: 3gpp 22.101, Section 10 - Emergency Calls

Value: 0

Public methods

compareTo

Added in API level 29
fun compareTo(other: EmergencyNumber): Int

Compare the display priority for this emergency number and the supplied emergency number.

Parameters
o the object to be compared.
emergencyNumber the supplied emergency number This value cannot be null.
Return
Int a negative value if the supplied emergency number has a lower display priority; a positive value if the supplied emergency number has a higher display priority; 0 if both have equal display priority.
Exceptions
java.lang.NullPointerException if the specified object is null
java.lang.ClassCastException if the specified object's type prevents it from being compared to this object.

describeContents

Added in API level 29
fun describeContents(): Int
Return
Int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR

equals

Added in API level 29
fun equals(other: Any?): Boolean
Parameters
obj the reference object with which to compare.
Return
Boolean true if this object is the same as the obj argument; false otherwise.

getCountryIso

Added in API level 29
fun getCountryIso(): String

Get the country code string (lowercase character) in ISO 3166 format of the emergency number.

Return
String the country code string (lowercase character) in ISO 3166 format. This value cannot be null.

getEmergencyCallRouting

Added in API level 29
fun getEmergencyCallRouting(): Int

Returns the emergency call routing information.

Some regions require some emergency numbers which are not routed using typical emergency call processing, but are instead placed as regular phone calls. The emergency call routing field provides information about how an emergency call will be routed when it is placed.

Return
Int the emergency call routing requirement Value is android.telephony.emergency.EmergencyNumber#EMERGENCY_CALL_ROUTING_UNKNOWN, android.telephony.emergency.EmergencyNumber#EMERGENCY_CALL_ROUTING_EMERGENCY, or android.telephony.emergency.EmergencyNumber#EMERGENCY_CALL_ROUTING_NORMAL

getEmergencyNumberSources

Added in API level 29
fun getEmergencyNumberSources(): MutableList<Int!>

Returns a list of sources of the emergency number.

Return
MutableList<Int!> a list of emergency number sources This value cannot be null.

getEmergencyServiceCategories

Added in API level 29
fun getEmergencyServiceCategories(): MutableList<Int!>

Returns the emergency service categories of the emergency number. Note: if the emergency number is in EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED, only EMERGENCY_SERVICE_CATEGORY_UNSPECIFIED is returned and it means the number is in all categories.

Return
MutableList<Int!> a list of the emergency service categories This value cannot be null.

getEmergencyUrns

Added in API level 29
fun getEmergencyUrns(): MutableList<String!>

Returns the list of emergency Uniform Resources Names (URN) of the emergency number. For example, urn:service:sos is the generic URN for contacting emergency services of all type. Reference: 3gpp 24.503, Section 5.1.6.8.1 - General; RFC 5031

Return
MutableList<String!> list of emergency Uniform Resources Names (URN) or an empty list if the emergency number does not have a specified emergency Uniform Resource Name. This value cannot be null.

getMnc

Added in API level 29
fun getMnc(): String

Get the Mobile Network Code of the emergency number.

Return
String the Mobile Network Code of the emergency number. This value cannot be null.

getNumber

Added in API level 29
fun getNumber(): String

Get the dialing number of the emergency number. The character in the number string is only the dial pad character('0'-'9', '*', '+', or '#'). For example: 911. If the number starts with carrier prefix, the carrier prefix is configured in CarrierConfigManager#KEY_EMERGENCY_NUMBER_PREFIX_STRING_ARRAY.

Return
String the dialing number. This value cannot be null.

hashCode

Added in API level 29
fun hashCode(): Int
Return
Int a hash code value for this object.

isFromSources

Added in API level 29
fun isFromSources(sources: Int): Boolean

Checks if the emergency number is from the specified emergency number source(s).

Parameters
sources Int: - the supplied emergency number sources Value is either 0 or a combination of android.telephony.emergency.EmergencyNumber#EMERGENCY_NUMBER_SOURCE_NETWORK_SIGNALING, android.telephony.emergency.EmergencyNumber#EMERGENCY_NUMBER_SOURCE_SIM, android.telephony.emergency.EmergencyNumber#EMERGENCY_NUMBER_SOURCE_DATABASE, android.telephony.emergency.EmergencyNumber#EMERGENCY_NUMBER_SOURCE_MODEM_CONFIG, and android.telephony.emergency.EmergencyNumber#EMERGENCY_NUMBER_SOURCE_DEFAULT
Return
Boolean true if the emergency number is from the specified emergency number source(s); false otherwise.

toString

Added in API level 29
fun toString(): String
Return
String a string representation of the object.

writeToParcel

Added in API level 29
fun writeToParcel(
    dest: Parcel,
    flags: Int
): Unit
Parameters
dest Parcel: The Parcel in which the object should be written. This value cannot be null.
flags Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 29
static val CREATOR: Parcelable.Creator<EmergencyNumber!>