# Geospatial.GeospatialTrackingState

Artifact: [androidx.xr.arcore:arcore](https://developer.android.com/jetpack/androidx/releases/xr-arcore) [View Source](https://cs.android.com/search?q=file:androidx/xr/arcore/Geospatial.kt+class:androidx.xr.arcore.Geospatial.GeospatialTrackingState) Added in [1.0.0](https://developer.android.com/jetpack/androidx/releases/xr-arcore#1.0.0)

*** ** * ** ***


```
class Geospatial.GeospatialTrackingState
```

<br />

*** ** * ** ***

Describes the state of Geospatial.

## Summary

| ### Public companion properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#ERROR_INTERNAL()` Earth localization has encountered an internal error. |
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#ERROR_NOT_AUTHORIZED()` The authorization provided by the application is not valid. |
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#ERROR_RESOURCE_EXHAUSTED()` The application has hit the rate limit for created Geospatial Sessions. |
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#NOT_RUNNING()` Geospatial is not running. |
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#PAUSED()` The Geospatial connection has been paused. |
| `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#RUNNING()` Geospatial is running and has not encountered an error. |

| ### Public functions |
|---|---|
| `open https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html` | `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState#toString()()` Returns a string representation of `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` for debugging. |

## Public companion properties

### ERROR_INTERNAL

```
val ERROR_INTERNAL: Geospatial.GeospatialTrackingState
```

Earth localization has encountered an internal error. The app should not attempt to recover from this error. Please see the Android logs for additional information.

### ERROR_NOT_AUTHORIZED

```
val ERROR_NOT_AUTHORIZED: Geospatial.GeospatialTrackingState
```

The authorization provided by the application is not valid.

- The associated Google Cloud project may not have enabled the ARCore API.

- When using API key authentication, this will happen if the API key in the manifest is invalid or unauthorized. It may also fail if the API key is restricted to a set of apps not including the current one.

- When using keyless authentication, this may happen when no OAuth client has been created, or when the signing key and package name combination does not match the values used in the Google Cloud project. It may also fail if Google Play Services isn't installed, is too old, or is malfunctioning for some reason (e.g. killed due to memory pressure).

### ERROR_RESOURCE_EXHAUSTED

```
val ERROR_RESOURCE_EXHAUSTED: Geospatial.GeospatialTrackingState
```

The application has hit the rate limit for created Geospatial Sessions. The developer should [request additional quota](https://cloud.google.com/docs/quota#requesting_higher_quota) for the ARCore API for their project from the Google Cloud Console.

Sessions are limited per-minute and enabling may succeed if retried. The application can disable and re-enable Geospatial to try again.

### NOT_RUNNING

```
val NOT_RUNNING: Geospatial.GeospatialTrackingState
```

Geospatial is not running. The Geospatial config must be enabled to use the Geospatial APIs. After enablement, Geospatial will not immediately enter the RUNNING state.

### PAUSED

```
val PAUSED: Geospatial.GeospatialTrackingState
```

The Geospatial connection has been paused. The connection may resume, and does not require action from the app. Tracked entities will enter the STOPPED state and must be destroyed.

### RUNNING

```
val RUNNING: Geospatial.GeospatialTrackingState
```

Geospatial is running and has not encountered an error. Functions to create anchors or convert poses may still fail if Geospatial is not tracking.

## Public functions

### toString

```
open fun toString(): String
```

Returns a string representation of `https://developer.android.com/reference/kotlin/androidx/xr/arcore/Geospatial.GeospatialTrackingState` for debugging.

Note: Not intended for production use.