Android APIs
public class

CdmaCellLocation

extends CellLocation
java.lang.Object
   ↳ android.telephony.CellLocation
     ↳ android.telephony.cdma.CdmaCellLocation

Class Overview

Represents the cell location on a CDMA phone.

Summary

Public Constructors
CdmaCellLocation()
Empty constructor.
CdmaCellLocation(Bundle bundle)
Initialize the object from a bundle.
Public Methods
static double convertQuartSecToDecDegrees(int quartSec)
Converts latitude or longitude from 0.25 seconds (as defined in the 3GPP2 C.S0005-A v6.0 standard) to decimal degrees
boolean equals(Object o)
Compares this instance with the specified object and indicates if they are equal.
void fillInNotifierBundle(Bundle bundleToFill)
Fill the cell location data into the intent notifier Bundle based on service state
int getBaseStationId()
int getBaseStationLatitude()
Latitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0.
int getBaseStationLongitude()
Longitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0.
int getNetworkId()
int getSystemId()
int hashCode()
Returns an integer hash code for this object.
void setCellLocationData(int baseStationId, int baseStationLatitude, int baseStationLongitude, int systemId, int networkId)
Set the cell location data.
void setCellLocationData(int baseStationId, int baseStationLatitude, int baseStationLongitude)
Set the cell location data.
void setStateInvalid()
Invalidate this object.
String toString()
Returns a string containing a concise, human-readable description of this object.
[Expand]
Inherited Methods
From class android.telephony.CellLocation
From class java.lang.Object

Public Constructors

public CdmaCellLocation ()

Added in API level 5

Empty constructor. Initializes the BID, SID, NID and base station latitude and longitude to invalid values.

public CdmaCellLocation (Bundle bundle)

Added in API level 5

Initialize the object from a bundle.

Parameters
bundle

Public Methods

public static double convertQuartSecToDecDegrees (int quartSec)

Added in API level 17

Converts latitude or longitude from 0.25 seconds (as defined in the 3GPP2 C.S0005-A v6.0 standard) to decimal degrees

Parameters
quartSec latitude or longitude in 0.25 seconds units
Returns
double latitude or longitude in decimal degrees units
Throws
IllegalArgumentException if value is less than -2592000, greater than 2592000, or is not a number.

public boolean equals (Object o)

Added in API level 5

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o. See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Parameters
o the object to compare this instance with.
Returns
boolean true if the specified object is equal to this Object; false otherwise.

public void fillInNotifierBundle (Bundle bundleToFill)

Added in API level 5

Fill the cell location data into the intent notifier Bundle based on service state

Parameters
bundleToFill intent notifier Bundle

public int getBaseStationId ()

Added in API level 5

Returns
int cdma base station identification number, -1 if unknown

public int getBaseStationLatitude ()

Added in API level 5

Latitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0. (http://www.3gpp2.org/public_html/specs/C.S0005-A_v6.0.pdf) It is represented in units of 0.25 seconds and ranges from -1296000 to 1296000, both values inclusive (corresponding to a range of -90 to +90 degrees). Integer.MAX_VALUE is considered invalid value.

Returns
int cdma base station latitude in units of 0.25 seconds, Integer.MAX_VALUE if unknown

public int getBaseStationLongitude ()

Added in API level 5

Longitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0. (http://www.3gpp2.org/public_html/specs/C.S0005-A_v6.0.pdf) It is represented in units of 0.25 seconds and ranges from -2592000 to 2592000, both values inclusive (corresponding to a range of -180 to +180 degrees). Integer.MAX_VALUE is considered invalid value.

Returns
int cdma base station longitude in units of 0.25 seconds, Integer.MAX_VALUE if unknown

public int getNetworkId ()

Added in API level 5

Returns
int cdma network identification number, -1 if unknown

public int getSystemId ()

Added in API level 5

Returns
int cdma system identification number, -1 if unknown

public int hashCode ()

Added in API level 5

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Returns
int this object's hash code.

public void setCellLocationData (int baseStationId, int baseStationLatitude, int baseStationLongitude, int systemId, int networkId)

Added in API level 5

Set the cell location data.

Parameters
baseStationId
baseStationLatitude
baseStationLongitude
systemId
networkId

public void setCellLocationData (int baseStationId, int baseStationLatitude, int baseStationLongitude)

Added in API level 5

Set the cell location data.

Parameters
baseStationId
baseStationLatitude
baseStationLongitude

public void setStateInvalid ()

Added in API level 5

Invalidate this object. The cell location data is set to invalid values.

public String toString ()

Added in API level 5

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Returns
String a printable representation of this object.