<!--
{
  "availability" : [
    "iOS: 2.0.0 -",
    "iPadOS: 2.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.6.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreLocation",
  "identifier" : "/documentation/CoreLocation/CLError-swift.struct",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Core Location"
    ],
    "preciseIdentifier" : "s:SC7CLErrorLeV"
  },
  "title" : "CLError"
}
-->

# CLError

A Core Location error.

```
struct CLError
```

## Overview

Instances of <doc://com.apple.documentation/documentation/Foundation/NSError> object delivered to the delegate use these error codes for the <doc://com.apple.documentation/documentation/Foundation/NSError/code> property of the error object.

## Topics

### Getting general errors

[`locationUnknown`](/documentation/CoreLocation/CLError-swift.struct/locationUnknown)

A constant that indicates the location manager was unable to obtain a location value right now.

[`denied`](/documentation/CoreLocation/CLError-swift.struct/denied)

A constant that indicates the user denied access to the location service.

[`promptDeclined`](/documentation/CoreLocation/CLError-swift.struct/promptDeclined)

A constant that indicates the user didn’t grant the requested temporary authorization.

[`network`](/documentation/CoreLocation/CLError-swift.struct/network)

A constant that indicates the network was unavailable or a network error occurred.

[`headingFailure`](/documentation/CoreLocation/CLError-swift.struct/headingFailure)

A constant that indicates the location manager can’t determine the heading.

[`rangingUnavailable`](/documentation/CoreLocation/CLError-swift.struct/rangingUnavailable)

A constant that indicates ranging is disabled.

[`rangingFailure`](/documentation/CoreLocation/CLError-swift.struct/rangingFailure)

A constant that indicates a general ranging error occurred.

[`CLError.Code`](/documentation/CoreLocation/CLError-swift.struct/Code)

Error codes returned by the location manager object.

### Getting region monitoring errors

[`regionMonitoringDenied`](/documentation/CoreLocation/CLError-swift.struct/regionMonitoringDenied)

A constant that indicates the user denied access to the region monitoring service.

[`regionMonitoringFailure`](/documentation/CoreLocation/CLError-swift.struct/regionMonitoringFailure)

A constant that indicates the location manager failed to monitor a registered region.

[`regionMonitoringSetupDelayed`](/documentation/CoreLocation/CLError-swift.struct/regionMonitoringSetupDelayed)

A constant that indicates Core Location couldn’t initialize the region monitoring feature immediately.

[`regionMonitoringResponseDelayed`](/documentation/CoreLocation/CLError-swift.struct/regionMonitoringResponseDelayed)

A constant that indicates Core Location will deliver events but they may be delayed.

### Getting geocoding errors

[`geocodeCanceled`](/documentation/CoreLocation/CLError-swift.struct/geocodeCanceled)

A constant that indicates the geocode request was canceled.

[`geocodeFoundNoResult`](/documentation/CoreLocation/CLError-swift.struct/geocodeFoundNoResult)

A constant that indicates the geocode request yielded no result.

[`geocodeFoundPartialResult`](/documentation/CoreLocation/CLError-swift.struct/geocodeFoundPartialResult)

A constant that indicates the geocode request yielded a partial result.

### Getting deferred location update errors

[`deferredFailed`](/documentation/CoreLocation/CLError-swift.struct/deferredFailed)

A constant that indicates the location manager didn’t enter deferred mode for an unknown reason.

[`deferredCanceled`](/documentation/CoreLocation/CLError-swift.struct/deferredCanceled)

A constant that indicates your app or the location manager canceled the request for deferred updates.

[`deferredAccuracyTooLow`](/documentation/CoreLocation/CLError-swift.struct/deferredAccuracyTooLow)

A constant that indicates deferred mode isn’t supported for the requested accuracy.

[`deferredDistanceFiltered`](/documentation/CoreLocation/CLError-swift.struct/deferredDistanceFiltered)

A constant that indicates deferred mode doesn’t support distance filters.

[`deferredNotUpdatingLocation`](/documentation/CoreLocation/CLError-swift.struct/deferredNotUpdatingLocation)

A constant that indicates the location manager didn’t enter deferred mode because location updates were already disabled or paused.

### Getting the error details

[`alternateRegion`](/documentation/CoreLocation/CLError-swift.struct/alternateRegion)

A region that location services can monitor more effectively.

### Comparing errors

### Type Properties

[`historicalLocationError`](/documentation/CoreLocation/CLError-swift.struct/historicalLocationError)


---

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)