Instance Method

locationManager:didEnterRegion:

Tells the delegate that the user entered the specified region.

Declaration

- (void)locationManager:(CLLocationManager *)manager didEnterRegion:(CLRegion *)region;

Parameters

manager

The location manager object reporting the event.

region

An object containing information about the region that was entered.

Discussion

Because regions are a shared application resource, every active location manager object delivers this message to its associated delegate. It does not matter which location manager actually registered the specified region. And if multiple location managers share a delegate object, that delegate receives the message multiple times.

The region object provided may not be the same one that was registered. As a result, you should never perform pointer-level comparisons to determine equality. Instead, use the region’s identifier string to determine if your delegate should respond.

See Also

Responding to Region Events

- locationManager:didExitRegion:

Tells the delegate that the user left the specified region.

- locationManager:didDetermineState:forRegion:

Tells the delegate about the state of the specified region.

- locationManager:monitoringDidFailForRegion:withError:

Tells the delegate that a region monitoring error occurred.

- locationManager:didStartMonitoringForRegion:

Tells the delegate that a new region is being monitored.

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