<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ARKit",
  "identifier" : "/documentation/ARKit/ARGeoTrackingStatus/StateReason-swift.enum/visualLocalizationFailed",
  "metadataVersion" : "0.1.0",
  "role" : "Case",
  "symbol" : {
    "kind" : "Case",
    "modules" : [
      "ARKit"
    ],
    "preciseIdentifier" : "c:@E@ARGeoTrackingStateReason@ARGeoTrackingStateReasonVisualLocalizationFailed"
  },
  "title" : "ARGeoTrackingStatus.StateReason.visualLocalizationFailed"
}
-->

# ARGeoTrackingStatus.StateReason.visualLocalizationFailed

Localization imagery failed to match the view from the device’s camera.

```
case visualLocalizationFailed
```

## Discussion

ARKit provides this reason when visual localization is taking too long. This indicates that the app has met all requirements for geo tracking, except for visual localization. In this situation, the app needs to ask the user to pan the device around the physical environment to acquire more camera-feed imagery. For more information, see [`Assisting the User with Visual Localization`](/documentation/ARKit/ARGeoTrackingStatus/State-swift.enum/localizing#Assisting-the-User-with-Visual-Localization).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)