GnssMeasurementsEvent.Callback


public static abstract class GnssMeasurementsEvent.Callback
extends Object

java.lang.Object
   ↳ android.location.GnssMeasurementsEvent.Callback


Used for receiving GNSS satellite measurements from the GNSS engine. Each measurement contains raw and computed data identifying a satellite. You can implement this interface and call LocationManager#registerGnssMeasurementsCallback.

Summary

Constants

int STATUS_LOCATION_DISABLED

This constant was deprecated in API level 31. Do not use.

int STATUS_NOT_ALLOWED

This constant was deprecated in API level 31. Do not use.

int STATUS_NOT_SUPPORTED

This constant was deprecated in API level 31. Do not use.

int STATUS_READY

This constant was deprecated in API level 31. Do not use.

Public constructors

Callback()

Public methods

void onGnssMeasurementsReceived(GnssMeasurementsEvent eventArgs)

Reports the latest collected GNSS Measurements.

void onStatusChanged(int status)

This method was deprecated in API level 31. Do not rely on this callback. From Android S onwards this callback will be invoked once with STATUS_READY in all cases for backwards compatibility, and then never invoked again. Use LocationManager APIs if you need to determine if GNSS measurements are supported or if location is off, etc...

Inherited methods

Constants

STATUS_LOCATION_DISABLED

Added in API level 24
Deprecated in API level 31
public static final int STATUS_LOCATION_DISABLED

This constant was deprecated in API level 31.
Do not use.

GPS provider or Location is disabled, updates will not be received until they are enabled.

Constant Value: 2 (0x00000002)

STATUS_NOT_ALLOWED

Added in API level 28
Deprecated in API level 31
public static final int STATUS_NOT_ALLOWED

This constant was deprecated in API level 31.
Do not use.

The client is not allowed to register for GNSS Measurements in general or in the requested mode.

Such a status is returned when a client tries to request a functionality from the GNSS chipset while another client has an ongoing request that does not allow such functionality to be performed.

If such a status is received, one would try again at a later time point where no other client is having a conflicting request.

Constant Value: 3 (0x00000003)

STATUS_NOT_SUPPORTED

Added in API level 24
Deprecated in API level 31
public static final int STATUS_NOT_SUPPORTED

This constant was deprecated in API level 31.
Do not use.

The system does not support tracking of GNSS Measurements.

This status will not change in the future.

Constant Value: 0 (0x00000000)

STATUS_READY

Added in API level 24
Deprecated in API level 31
public static final int STATUS_READY

This constant was deprecated in API level 31.
Do not use.

GNSS Measurements are successfully being tracked, it will receive updates once they are available.

Constant Value: 1 (0x00000001)

Public constructors

Callback

Added in API level 24
public Callback ()

Public methods

onGnssMeasurementsReceived

Added in API level 24
public void onGnssMeasurementsReceived (GnssMeasurementsEvent eventArgs)

Reports the latest collected GNSS Measurements.

Parameters
eventArgs GnssMeasurementsEvent

onStatusChanged

Added in API level 24
Deprecated in API level 31
public void onStatusChanged (int status)

This method was deprecated in API level 31.
Do not rely on this callback. From Android S onwards this callback will be invoked once with STATUS_READY in all cases for backwards compatibility, and then never invoked again. Use LocationManager APIs if you need to determine if GNSS measurements are supported or if location is off, etc...

Reports the latest status of the GNSS Measurements sub-system.

Parameters
status int: Value is STATUS_NOT_SUPPORTED, STATUS_READY, STATUS_LOCATION_DISABLED, or STATUS_NOT_ALLOWED