Geospatial.State
public final class Geospatial.State
Describes the state of Geospatial. The State must be RUNNING to use Geospatial functionality. If Geospatial has entered an error state other than PAUSED, Geospatial must be disabled and re-enabled to use Geospatial again.
Summary
Public fields |
|
|---|---|
static final @NonNull Geospatial.State |
Earth localization has encountered an internal error. |
static final @NonNull Geospatial.State |
The authorization provided by the application is not valid. |
static final @NonNull Geospatial.State |
The application has hit the rate limit for created Geospatial Sessions. |
static final @NonNull Geospatial.State |
Geospatial is not running. |
static final @NonNull Geospatial.State |
The Geospatial connection has been paused. |
static final @NonNull Geospatial.State |
Geospatial is running and has not encountered an error. |
Public fields
ERROR_INTERNAL
public static final @NonNull Geospatial.State 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.State 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.State ERROR_RESOURCE_EXHAUSTED
The application has hit the rate limit for created Geospatial Sessions. The developer should request additional 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.State 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.State 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.State 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.