Instance Method


Tells the delegate that one or more beacons are in range.


- (void)locationManager:(CLLocationManager *)manager didRangeBeacons:(NSArray<CLBeacon *> *)beacons inRegion:(CLBeaconRegion *)region;



The location manager object reporting the event.


An array of CLBeacon objects representing the beacons currently in range. If beacons is empty, you can assume that no beacons matching the specified region are in range. When a specific beacon is no longer in beacons, that beacon is no longer received by the device. You can use the information in the CLBeacon objects to determine the range of each beacon and its identifying information.


The region object containing the parameters that were used to locate the beacons.


The location manager calls this method when a new set of beacons becomes available in the specified region or when a beacon goes out of range. The location manager also calls this method when the range of a beacon changes; for example, when a beacon gets closer.

See Also

Responding to Ranging Events

- locationManager:didRangeBeacons:satisfyingConstraint:

Tells the delegate that a beacon satisfying the constraint was detected.

- locationManager:didFailRangingBeaconsForConstraint:error:

Tells the delegate that no beacons were detected that satisfy the constraint.

- locationManager:rangingBeaconsDidFailForRegion:withError:

Tells the delegate that an error occurred while gathering ranging information for a set of beacons.