Instance Method

locationManager:didUpdateToLocation:fromLocation:

Tells the delegate that a new location value is available.

Declaration

- (void)locationManager:(CLLocationManager *)manager didUpdateToLocation:(CLLocation *)newLocation fromLocation:(CLLocation *)oldLocation;

Parameters

manager

The location manager object that generated the update event.

newLocation

The new location data.

oldLocation

The location data from the previous update. If this is the first update event delivered by this location manager, this parameter is nil.

Discussion

By the time this message is delivered to your delegate, the new location data is also available directly from the CLLocationManager object. The newLocation parameter may contain the data that was cached from a previous usage of the location service. You can use the timestamp property of the location object to determine how recent the location data is.

See Also

Responding to Location Events

- locationManager:didUpdateLocations:

Tells the delegate that new location data is available.

- locationManager:didFailWithError:

Tells the delegate that the location manager was unable to retrieve a location value.

- locationManager:didFinishDeferredUpdatesWithError:

Tells the delegate that updates will no longer be deferred.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software