Added in API level 1
Deprecated in API level 31

GsmCellLocation

Kotlin |Java

open class GsmCellLocation : CellLocation

kotlin.Any
↳	android.telephony.CellLocation
	↳	android.telephony.gsm.GsmCellLocation

Represents the cell location on a GSM phone.

Summary

Public constructors
`GsmCellLocation()` Empty constructor.
`GsmCellLocation(bundle: Bundle!)` Initialize the object from a bundle.

Public methods
open Boolean	`equals(other: Any?)` Indicates whether some other object is "equal to" this one.
open Unit	`fillInNotifierBundle(m: Bundle!)` Set intent notifier Bundle based on service state
open Int	`getCid()`
open Int	`getLac()`
open Int	`getPsc()` On a UMTS network, returns the primary scrambling code of the serving cell.
open Int	`hashCode()` Returns a hash code value for the object.
open Unit	`setLacAndCid(lac: Int, cid: Int)` Set the location area code and the cell id.
open Unit	`setStateInvalid()` Invalidate this object.
open String	`toString()` Returns a string representation of the object.

Inherited functions

From class CellLocation

CellLocation!

getEmpty()

Return a new CellLocation object representing an unknown location, or null for unknown/none phone radio types.

Unit

requestLocationUpdate()

Request an updated CellLocation for callers targeting SDK 30 or older. Whenever Android is aware of location changes, a callback will automatically be sent to all registrants of PhoneStateListener.LISTEN_CELL_LOCATION. This API requests an additional location update for cases where power saving might cause location updates to be missed.

This method is a no-op for callers targeting SDK level 31 or greater.

This method is a no-op for callers that target SDK level 29 or 30 and lack android.Manifest.permission#ACCESS_FINE_LOCATION.

This method is a no-op for callers that target SDK level 28 or below and lack android.Manifest.permission#ACCESS_COARSE_LOCATION.

Public constructors

GsmCellLocation

Added in API level 1

GsmCellLocation()

Empty constructor. Initializes the LAC and CID to -1.

GsmCellLocation

Added in API level 1

GsmCellLocation(bundle: Bundle!)

Initialize the object from a bundle.

Public methods

equals

Added in API level 1

open fun equals(other: Any?): Boolean

Deprecated: Deprecated in Java.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters
`obj`	the reference object with which to compare.

Return
`Boolean`	`true` if this object is the same as the obj argument; `false` otherwise.

fillInNotifierBundle

Added in API level 1

open fun fillInNotifierBundle(m: Bundle!): Unit

Deprecated: Deprecated in Java.

Set intent notifier Bundle based on service state

Parameters
`m`	Bundle!: intent notifier Bundle

getCid

Added in API level 1

open fun getCid(): Int

Deprecated: Deprecated in Java.

Return
`Int`	gsm cell id, -1 if unknown or invalid, 0xffff max legal value

getLac

Added in API level 1

open fun getLac(): Int

Deprecated: Deprecated in Java.

Return
`Int`	gsm location area code, -1 if unknown, 0xffff max legal value

getPsc

Added in API level 9
Deprecated in API level 31

open fun getPsc(): Int

Deprecated: Deprecated in Java.

On a UMTS network, returns the primary scrambling code of the serving cell.

Return
`Int`	primary scrambling code for UMTS, -1 if unknown or GSM

hashCode

Added in API level 1

open fun hashCode(): Int

Deprecated: Deprecated in Java.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Return
`Int`	a hash code value for this object.

setLacAndCid

Added in API level 1

open fun setLacAndCid(
    lac: Int, 
    cid: Int
): Unit

Deprecated: Deprecated in Java.

Set the location area code and the cell id.

setStateInvalid

Added in API level 1

open fun setStateInvalid(): Unit

Deprecated: Deprecated in Java.

Invalidate this object. The location area code and the cell id are set to -1.

toString

Added in API level 1

open fun toString(): String

Deprecated: Deprecated in Java.

Returns a string representation of the object.

Return
`String`	a string representation of the object.