Instance Property


The minimum distance (measured in meters) a device must move horizontally before an update event is generated.


@property(assign, nonatomic) CLLocationDistance distanceFilter;


This distance is measured relative to the previously delivered location. Use the value kCLDistanceFilterNone to be notified of all movements. The default value of this property is kCLDistanceFilterNone.

This property is used only in conjunction with the standard location services and is not used when monitoring significant location changes.

Special Considerations

In iOS, this property is declared as nonatomic. In macOS, it is declared as atomic.

See Also

Initiating Standard Location Updates

- startUpdatingLocation

Starts the generation of updates that report the user’s current location.

- stopUpdatingLocation

Stops the generation of location updates.

- requestLocation

Requests the one-time delivery of the user’s current location.


A Boolean value indicating whether the location manager object may pause location updates.


A Boolean value indicating whether the app should receive location updates when suspended.


A Boolean indicating whether the status bar changes its appearance when location services are used in the background.


The accuracy of the location data.


The type of user activity associated with the location updates.


Constants indicating the type of activity associated with location updates.