# GnssMeasurementsEvent.Callback

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Callback

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/location/GnssMeasurementsEvent.Callback "View this page in Java")  

```
abstract class Callback
```

|---|----------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                     ||
| ↳ | [android.location.GnssMeasurementsEvent.Callback](https://developer.android.com/reference/kotlin/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 android.location.LocationManager#registerGnssMeasurementsCallback.

## Summary

|                                                                                                                                                                  Constants                                                                                                                                                                  ||
|----------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_LOCATION_DISABLED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_LOCATION_DISABLED:kotlin.Int) GPS provider or Location is disabled, updates will not be received until they are enabled. |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_NOT_ALLOWED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_NOT_ALLOWED:kotlin.Int) The client is not allowed to register for GNSS Measurements in general or in the requested mode.       |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_NOT_SUPPORTED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_NOT_SUPPORTED:kotlin.Int) The system does not support tracking of GNSS Measurements.                                         |
| static[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [STATUS_READY](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_READY:kotlin.Int) GNSS Measurements are successfully being tracked, it will receive updates once they are available.                 |

|                                                         Public constructors                                                         ||
|----------------------------------------------------------------------------------------------------------------------------------|---|
| [Callback](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#Callback())`()` <br /> |

|                                                                                                                                                                                                                           Public methods                                                                                                                                                                                                                            ||
|----------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onGnssMeasurementsReceived](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#onGnssMeasurementsReceived(android.location.GnssMeasurementsEvent))`(`eventArgs:` `[GnssMeasurementsEvent](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent)!`)` Reports the latest collected GNSS Measurements. |
| open[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [onStatusChanged](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#onStatusChanged(kotlin.Int))`(`status:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Reports the latest status of the GNSS Measurements sub-system.                                                                            |

## Constants

### STATUS_LOCATION_DISABLED

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val STATUS_LOCATION_DISABLED: Int
```

**Deprecated:** *Do not use.*

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

    Value: 2

### STATUS_NOT_ALLOWED

Added in[API level 28](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val STATUS_NOT_ALLOWED: Int
```

**Deprecated:** *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.  

    Value: 3

### STATUS_NOT_SUPPORTED

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val STATUS_NOT_SUPPORTED: Int
```

**Deprecated:** *Do not use.*

The system does not support tracking of GNSS Measurements.

This status will not change in the future.  

    Value: 0

### STATUS_READY

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val STATUS_READY: Int
```

**Deprecated:** *Do not use.*

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

    Value: 1

## Public constructors

### Callback

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
Callback()
```

## Public methods

### onGnssMeasurementsReceived

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onGnssMeasurementsReceived(eventArgs: GnssMeasurementsEvent!): Unit
```

Reports the latest collected GNSS Measurements.  

### onStatusChanged

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 31](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun onStatusChanged(status: Int): Unit
```

**Deprecated:** *Do not rely on this callback. From Android S onwards this callback will be invoked once with[STATUS_READY](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_READY:kotlin.Int)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](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):Value is[android.location.GnssMeasurementsEvent.Callback#STATUS_NOT_SUPPORTED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_NOT_SUPPORTED:kotlin.Int),[android.location.GnssMeasurementsEvent.Callback#STATUS_READY](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_READY:kotlin.Int),[android.location.GnssMeasurementsEvent.Callback#STATUS_LOCATION_DISABLED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_LOCATION_DISABLED:kotlin.Int), or[android.location.GnssMeasurementsEvent.Callback#STATUS_NOT_ALLOWED](https://developer.android.com/reference/kotlin/android/location/GnssMeasurementsEvent.Callback#STATUS_NOT_ALLOWED:kotlin.Int) |