# 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)

*** ** * ** ***


```
public final class Geospatial.GeospatialTrackingState
```

<br />

*** ** * ** ***

Describes the state of Geospatial.

## Summary

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

| ### Public methods |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/xr/arcore/Geospatial.GeospatialTrackingState#toString()()` Returns a string representation of `https://developer.android.com/reference/androidx/xr/arcore/Geospatial.GeospatialTrackingState` for debugging. |

## Public fields

### ERROR_INTERNAL

```
public static final @NonNull Geospatial.GeospatialTrackingState ERROR_INTERNAL
```

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

```
public static final @NonNull Geospatial.GeospatialTrackingState ERROR_NOT_AUTHORIZED
```

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

```
public static final @NonNull Geospatial.GeospatialTrackingState ERROR_RESOURCE_EXHAUSTED
```

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

```
public static final @NonNull Geospatial.GeospatialTrackingState NOT_RUNNING
```

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

```
public static final @NonNull Geospatial.GeospatialTrackingState PAUSED
```

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

```
public static final @NonNull Geospatial.GeospatialTrackingState RUNNING
```

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 methods

### toString

```
public @NonNull String toString()
```

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

Note: Not intended for production use.