Stay organized with collections
Save and categorize content based on your preferences.
CellLocation
public
abstract
class
CellLocation
extends Object
This class was deprecated
in API level 31.
use CellIdentity.
Abstract class that represents the location of the device.
Summary
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.
|
|
Public constructors
CellLocation
public CellLocation ()
Public methods
getEmpty
public static CellLocation getEmpty ()
Return a new CellLocation object representing an unknown
location, or null for unknown/none phone radio types.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# CellLocation\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nDeprecated in [API level\n31](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Ctors](#pubctors) \\| [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \n\nCellLocation\n============\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/telephony/CellLocation \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\n\n\nabstract\nclass\nCellLocation\n`\n\n\n`\n\nextends `[Object](/reference/java/lang/Object)`\n\n\n`\n\n`\n\n\n`\n\n|---|--------------------------------|\n| [java.lang.Object](/reference/java/lang/Object) ||\n| ↳ | android.telephony.CellLocation |\n\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known direct subclasses [CdmaCellLocation](/reference/android/telephony/cdma/CdmaCellLocation), [GsmCellLocation](/reference/android/telephony/gsm/GsmCellLocation) |------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | [CdmaCellLocation](/reference/android/telephony/cdma/CdmaCellLocation) | *This class was deprecated in API level 31. use [CellIdentity](/reference/android/telephony/CellIdentity).* | | [GsmCellLocation](/reference/android/telephony/gsm/GsmCellLocation) | *This class was deprecated in API level 31. use [CellIdentity](/reference/android/telephony/CellIdentity).* | |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n\n**This class was deprecated\nin API level 31.** \n\nuse [CellIdentity](/reference/android/telephony/CellIdentity).\n\nAbstract class that represents the location of the device.\n\n\u003cbr /\u003e\n\nSummary\n-------\n\n| ### Public constructors ||\n|----------------------------------------------------------------------------------|---|\n| ` `[CellLocation](/reference/android/telephony/CellLocation#CellLocation())`() ` |\n\n| ### Public methods ||\n|---------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` static `[CellLocation](/reference/android/telephony/CellLocation) | ` `[getEmpty](/reference/android/telephony/CellLocation#getEmpty())`() ` Return a new CellLocation object representing an unknown location, or null for unknown/none phone radio types. |\n| ` static void` | ` `[requestLocationUpdate](/reference/android/telephony/CellLocation#requestLocationUpdate())`() ` *This method is deprecated. use [TelephonyManager.requestCellInfoUpdate](/reference/android/telephony/TelephonyManager#requestCellInfoUpdate(java.util.concurrent.Executor,%20android.telephony.TelephonyManager.CellInfoCallback)).* |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` `[java.lang.Object](/reference/java/lang/Object)` ` |---------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](/reference/java/lang/Object) | ` `[clone](/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](/reference/java/lang/Object)` obj) ` Indicates whether some other object is \"equal to\" this one. | | ` void` | ` `[finalize](/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](/reference/java/lang/Class)`\u003c?\u003e` | ` `[getClass](/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this `Object`. | | ` int` | ` `[hashCode](/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](/reference/java/lang/String) | ` `[toString](/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](/reference/java/lang/Object#wait(long,%20int))`(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](/reference/java/lang/Object#wait(long))`(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](/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||\n\nPublic constructors\n-------------------\n\n### CellLocation\n\n```\npublic CellLocation ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nPublic methods\n--------------\n\n### getEmpty\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic static CellLocation getEmpty ()\n```\n\nReturn a new CellLocation object representing an unknown\nlocation, or null for unknown/none phone radio types.\n\n\u003cbr /\u003e\n\n| Returns ||\n|-----------------------------------------------------------|--------|\n| [CellLocation](/reference/android/telephony/CellLocation) | \u003cbr /\u003e |\n\n### requestLocationUpdate\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic static void requestLocationUpdate ()\n```\n\n\n**This method is deprecated.** \n\nuse [TelephonyManager.requestCellInfoUpdate](/reference/android/telephony/TelephonyManager#requestCellInfoUpdate(java.util.concurrent.Executor,%20android.telephony.TelephonyManager.CellInfoCallback)).\n\nRequest an updated CellLocation for callers targeting SDK 30 or older.\n\nWhenever Android is aware of location changes, a callback will automatically be sent to\nall registrants of [PhoneStateListener.LISTEN_CELL_LOCATION](/reference/android/telephony/PhoneStateListener#LISTEN_CELL_LOCATION). This API requests an\nadditional location update for cases where power saving might cause location updates to be\nmissed.\n\nThis method is a no-op for callers targeting SDK level 31 or greater.\n\nThis method is a no-op for callers that target SDK level 29 or 30 and lack\n[Manifest.permission.ACCESS_FINE_LOCATION](/reference/android/Manifest.permission#ACCESS_FINE_LOCATION).\n\nThis method is a no-op for callers that target SDK level 28 or below and lack\n[Manifest.permission.ACCESS_COARSE_LOCATION](/reference/android/Manifest.permission#ACCESS_COARSE_LOCATION).\n\n\u003cbr /\u003e"]]
