Stay organized with collections
Save and categorize content based on your preferences.
GARTerrainAnchorState
Summary
Enumerations
GARTerrainAnchorState
GARTerrainAnchorState
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-14 UTC.
[null,null,["Last updated 2025-07-14 UTC."],[[["\u003cp\u003e\u003ccode\u003eGARTerrainAnchorState\u003c/code\u003e describes the status of an asynchronous operation initiated by \u003ccode\u003ecreateAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003ePossible states include \u003ccode\u003eNone\u003c/code\u003e, \u003ccode\u003eTaskInProgress\u003c/code\u003e, \u003ccode\u003eSuccess\u003c/code\u003e, \u003ccode\u003eErrorInternal\u003c/code\u003e, \u003ccode\u003eErrorNotAuthorized\u003c/code\u003e, and \u003ccode\u003eErrorUnsupportedLocation\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eErrors can arise from internal issues, authorization failures, or unsupported locations lacking terrain data.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful resolution indicates the terrain anchor has been successfully established.\u003c/p\u003e\n"]]],["The `GARTerrainAnchorState` enum describes the status of an asynchronous operation initiated by `createAnchorWithCoordinate`. Possible states include `GARTerrainAnchorStateNone`, `GARTerrainAnchorStateTaskInProgress`, and `GARTerrainAnchorStateSuccess`. Error states are `GARTerrainAnchorStateErrorInternal`, indicating an internal failure; `GARTerrainAnchorStateErrorNotAuthorized`, related to authentication issues; and `GARTerrainAnchorStateErrorUnsupportedLocation`, indicating lack of terrain data. Each state represents a stage in the process or a specific error condition.\n"],null,["# GARTerrainAnchorState\n=====================\n\nSummary\n-------\n\n| ### Enumerations ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [GARTerrainAnchorState](#garterrainanchorstate)`{` ` `[GARTerrainAnchorStateNone](#garterrainanchorstatenone)` = 0,` ` `[GARTerrainAnchorStateTaskInProgress](#garterrainanchorstatetaskinprogress)` = 1,` ` `[GARTerrainAnchorStateSuccess](#garterrainanchorstatesuccess)` = 2,` ` `[GARTerrainAnchorStateErrorInternal](#garterrainanchorstateerrorinternal)` = -1,` ` `[GARTerrainAnchorStateErrorNotAuthorized](#garterrainanchorstateerrornotauthorized)` = -2,` ` `[GARTerrainAnchorStateErrorUnsupportedLocation](#garterrainanchorstateerrorunsupportedlocation)` = -3` `}` | enum Describes the state of an asynchronous operation launched by [createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error: (GARSession(Geospatial))](/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveterrain:eastupsouthqanchor:completionhandler:error:). |\n\nEnumerations\n------------\n\n### GARTerrainAnchorState\n\n```text\n GARTerrainAnchorState\n``` \nDescribes the state of an asynchronous operation launched by [createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error: (GARSession(Geospatial))](/ar/reference/ios/category/GARSession(Geospatial)#createanchorwithcoordinate:altitudeaboveterrain:eastupsouthqanchor:completionhandler:error:).\n\n| Properties ||\n|-----------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| GARTerrainAnchorStateErrorInternal | Internal error. No recommended mitigation. |\n| GARTerrainAnchorStateErrorNotAuthorized | The operation failed due to an authentication or authorization error. This may occur due to a number of reasons: - The Google Cloud project may not have enabled the ARCore API. - If the session was created with an API Key, the API Key may be invalid or deleted, or restricted to exclude the app's bundle Id. - If the session was not created with an API Key, a token may not have been provided, or the provided token may be invalid. - The requested operation may not be permitted. \u003cbr /\u003e |\n| GARTerrainAnchorStateErrorUnsupportedLocation | There is no terrain info at this location, such as the center of the ocean. |\n| GARTerrainAnchorStateNone | Not a valid value for a Terrain anchor operation. |\n| GARTerrainAnchorStateSuccess | This anchor has been resolved successfully. |\n| GARTerrainAnchorStateTaskInProgress | This anchor has started the process of resolving, but it is not complete. |"]]
