Tries to cancel the execution of this operation. If the operation was cancelled by this
invocation, this method returnstrueand the associated callback (if any) will never be
invoked.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eResolveAnchorOnTerrainFuture\u003c/code\u003e handles the asynchronous operation of resolving an anchor to the terrain.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods to check the operation status, cancel it, and retrieve the resolved anchor or the terrain anchor state.\u003c/p\u003e\n"],["\u003cp\u003eYou can get the resolved anchor using \u003ccode\u003egetResultAnchor()\u003c/code\u003e when the operation is done and successful.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egetResultTerrainAnchorState()\u003c/code\u003e to get the terrain anchor state upon operation completion.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecancel()\u003c/code\u003e attempts to cancel the resolution, and \u003ccode\u003egetState()\u003c/code\u003e provides the current status of the operation.\u003c/p\u003e\n"]]],[],null,["# ResolveAnchorOnTerrainFuture\n\n`\npublic class\n`**ResolveAnchorOnTerrainFuture**`\n` \nHandle to an async operation launched by [Earth.resolveAnchorOnTerrainAsync(double, double, double, float, float, float, float, BiConsumer)](/ar/reference/java/com/google/ar/core/Earth#resolveAnchorOnTerrainAsync(double,%20double,%20double,%20float,%20float,%20float,%20float,%20java.util.function.BiConsumer\u003ccom.google.ar.core.Anchor,%20com.google.ar.core.Anchor.TerrainAnchorState\u003e)). See the [Terrain\nanchors developer guide](https://developers.google.com/ar/develop/geospatial/java/anchors#terrain-anchors) for more information. \n\nPublic Methods\n--------------\n\n|----------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` boolean ` | [cancel](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#cancel())`()` Tries to cancel the execution of this operation. |\n| ` `[Anchor](/ar/reference/java/com/google/ar/core/Anchor)` ` | [getResultAnchor](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#getResultAnchor())`()` Returns the resolved anchor, when [Future.getState()](/ar/reference/java/com/google/ar/core/Future#getState()) returns [FutureState.DONE](/ar/reference/java/com/google/ar/core/FutureState#DONE) and [getResultTerrainAnchorState()](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#getResultTerrainAnchorState()) returns [Anchor.TerrainAnchorState.SUCCESS](/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState#SUCCESS). |\n| ` `[Anchor.TerrainAnchorState](/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState)` ` | [getResultTerrainAnchorState](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#getResultTerrainAnchorState())`()` Returns the result status of the resolving operation, when [Future.getState()](/ar/reference/java/com/google/ar/core/Future#getState()) returns [FutureState.DONE](/ar/reference/java/com/google/ar/core/FutureState#DONE). |\n| ` `[FutureState](/ar/reference/java/com/google/ar/core/FutureState)` ` | [getState](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#getState())`()` Get the current state of the future. |\n\nInherited Methods\n-----------------\n\nFrom `class\njava.lang.Object` \n\n|---------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|\n| ` `[Object](https://developer.android.com/reference/java/lang/Object)` ` | clone`()` |\n| ` boolean ` | equals`(`[Object](https://developer.android.com/reference/java/lang/Object)` arg0)` |\n| ` void ` | finalize`()` |\n| ` final `[Class](https://developer.android.com/reference/java/lang/Class)`\u003c?\u003e ` | getClass`()` |\n| ` int ` | hashCode`()` |\n| ` final void ` | notify`()` |\n| ` final void ` | notifyAll`()` |\n| ` `[String](https://developer.android.com/reference/java/lang/String)` ` | toString`()` |\n| ` final void ` | wait`(long arg0, int arg1)` |\n| ` final void ` | wait`(long arg0)` |\n| ` final void ` | wait`()` |\n\nFrom `interface\n`[com.google.ar.core.Future](/ar/reference/java/com/google/ar/core/Future) \n\n|---------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------|\n| ` abstract boolean ` | [cancel](/ar/reference/java/com/google/ar/core/Future#cancel())`()` Tries to cancel the execution of this operation. |\n| ` abstract `[FutureState](/ar/reference/java/com/google/ar/core/FutureState)` ` | [getState](/ar/reference/java/com/google/ar/core/Future#getState())`()` Get the current state of the future. |\n\nPublic Methods\n--------------\n\n#### public\nboolean\ncancel\n()\n\n### cancel\n\n```java\npublic boolean cancel()\n``` \nTries to cancel the execution of this operation. If the operation was cancelled by this\ninvocation, this method returns `true` and the associated callback (if any) will never be\ninvoked.\n\n#### public\n[Anchor](/ar/reference/java/com/google/ar/core/Anchor)\ngetResultAnchor\n()\n\n### getResultAnchor\n\n```java\npublic Anchor getResultAnchor()\n``` \nReturns the resolved anchor, when [Future.getState()](/ar/reference/java/com/google/ar/core/Future#getState()) returns [FutureState.DONE](/ar/reference/java/com/google/ar/core/FutureState#DONE)\nand [getResultTerrainAnchorState()](/ar/reference/java/com/google/ar/core/ResolveAnchorOnTerrainFuture#getResultTerrainAnchorState()) returns [Anchor.TerrainAnchorState.SUCCESS](/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState#SUCCESS).\nOtherwise, returns `null`.\n\n#### public\n[Anchor.TerrainAnchorState](/ar/reference/java/com/google/ar/core/Anchor.TerrainAnchorState)\ngetResultTerrainAnchorState\n()\n\n### getResultTerrainAnchorState\n\n```java\npublic Anchor.TerrainAnchorState getResultTerrainAnchorState()\n``` \nReturns the result status of the resolving operation, when [Future.getState()](/ar/reference/java/com/google/ar/core/Future#getState()) returns\n[FutureState.DONE](/ar/reference/java/com/google/ar/core/FutureState#DONE).\n\n#### public\n[FutureState](/ar/reference/java/com/google/ar/core/FutureState)\ngetState\n()\n\n### getState\n\n```java\npublic FutureState getState()\n``` \nGet the current state of the future."]]
