# GAREarthState

## Summary

| ### Enumerations ||
|---|---|
| `https://developers.google.com/ar/reference/ios/group/GAREarthState#garearthstate{ https://developers.google.com/ar/reference/ios/group/GAREarthState#garearthstateenabled = 0, https://developers.google.com/ar/reference/ios/group/GAREarthState#garearthstateerrorinternal = -1, https://developers.google.com/ar/reference/ios/group/GAREarthState#garearthstateerrornotauthorized = -2, https://developers.google.com/ar/reference/ios/group/GAREarthState#garearthstateerrorresourceexhausted = -3 }` | enumDescribes the current state of `https://developers.google.com/ar/reference/ios/interface/GAREarth#interface_g_a_r_earth`, containing the possible values of `https://developers.google.com/ar/reference/ios/interface/GAREarth#earthstate`. |

## Enumerations

### GAREarthState

```
 GAREarthState
```
Describes the current state of `https://developers.google.com/ar/reference/ios/interface/GAREarth#interface_g_a_r_earth`, containing the possible values of `https://developers.google.com/ar/reference/ios/interface/GAREarth#earthstate`.

When `https://developers.google.com/ar/reference/ios/interface/GAREarth#trackingstate` does not become `https://developers.google.com/ar/reference/ios/group/GARTrackingState#gartrackingstatetracking`, this may contain the cause of this failure.

| Properties ||
|---|---|
| `GAREarthStateEnabled` | `https://developers.google.com/ar/reference/ios/interface/GAREarth#interface_g_a_r_earth` is enabled, and has not encountered any problems. Localization is enabled and functioning. Use `https://developers.google.com/ar/reference/ios/interface/GAREarth#trackingstate` to determine if it can be used. |
| `GAREarthStateErrorInternal` | Earth localization has encountered an internal error. The app should not attempt to recover from this error. Check the iOS device logs for more information. |
| `GAREarthStateErrorNotAuthorized` | The application failed to authenticate with Google Cloud. This may happen if: - The Google Cloud Project has not enabled the ARCore API. - The provided API key is invalid. - The provided auth token is expired or invalid. - No credentials have been provided. <br /> |
| `GAREarthStateErrorResourceExhausted` | The application has exhausted the quota allotted to the given Google Cloud project. 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. |