Information about a detected iBeacon and the relative distance to it.


class CLBeacon : NSObject


The CLBeacon class represents a beacon that was encountered during region monitoring. You do not create instances of this class directly. The location manager object reports encountered beacons to its associated delegate object. You can use the information in a beacon object to identify which beacon was encountered.

The identity of a beacon is defined by its proximityUUID, major, and minor properties. These values are coded into the beacon itself. For a more thorough description of the meaning of those values, see CLBeaconRegion.


Identifying a Beacon

var proximityUUID: UUID

The proximity ID of the beacon.

var major: NSNumber

The most significant value in the beacon.

var minor: NSNumber

The least significant value in the beacon.

Determining the Beacon Distance

var proximity: CLProximity

The relative distance to the beacon.

var accuracy: CLLocationAccuracy

The accuracy of the proximity value, measured in meters from the beacon.

var rssi: Int

The received signal strength of the beacon, measured in decibels.


enum CLProximity

Constants that reflect the relative distance to a beacon.


Inherits From

See Also


Determining the Proximity to an iBeacon

Learn how to detect beacons and determine the relative distance to them.

Turning an iOS Device into an iBeacon

Learn how to broadcast iBeacon signals from an iOS device.

class CLBeaconRegion

A region used to detect iBeacon hardware.