---
title: CLBeacon
framework: corelocation
role: symbol
role_heading: Class
path: corelocation/clbeacon
---

# CLBeacon

Information about an observed iBeacon device and its relative distance to a person’s device.

## Declaration

```swift
class CLBeacon
```

## Mentioned in

Turning an iOS device into an iBeacon device

## Overview

Overview The CLBeacon class represents a beacon that was observed during beacon ranging. You do not create instances of this class directly. The location manager (CLLocationManager) object reports observed beacons to its associated delegate object. The identity of a beacon is defined by its uuid, 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.

## Topics

### Getting the beacon identity

- [uuid](corelocation/clbeacon/uuid.md)
- [major](corelocation/clbeacon/major.md)
- [minor](corelocation/clbeacon/minor.md)
- [proximityUUID](corelocation/clbeacon/proximityuuid.md)

### Determining the distance to the beacon

- [proximity](corelocation/clbeacon/proximity.md)
- [CLProximity](corelocation/clproximity.md)
- [accuracy](corelocation/clbeacon/accuracy.md)
- [rssi](corelocation/clbeacon/rssi.md)

### Getting the observation timestamp

- [timestamp](corelocation/clbeacon/timestamp.md)

### Initializers

- [init(coder:)](corelocation/clbeacon/init(coder:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### iBeacon

- [Ranging for Beacons](corelocation/ranging-for-beacons.md)
- [Determining the proximity to an iBeacon device](corelocation/determining-the-proximity-to-an-ibeacon-device.md)
- [Turning an iOS device into an iBeacon device](corelocation/turning-an-ios-device-into-an-ibeacon-device.md)
- [CLCondition](corelocation/clcondition-swift.protocol.md)