Latest 2.0.0
License MIT
Platforms ios 10.0, requires ARC
Dependencies EddystoneScanner, Socket.IO-Client-Swift
Frameworks CoreData, SystemConfiguration, CoreBluetooth, CoreLocation, UserNotifications, SafariServices

NearBee SDK for iOS


NearBee SDK is an easy way to enable proximity marketing through an Eddystone-compliant BLE network.


Using Cocoapods (recommended):

Add the following to your Podfile in your project, we are supporting iOS 10.0+ make sure your pod has proper platform set.

platform :ios, '10.0'
target '<My-App-Target>''
  pod 'NearBee'

Run pod install in the project directory


  1. Download or clone this repo on your system.
  2. Drag and drop the NearBee.framework file into your Xcode project. Make sure that "Copy Items to Destination’s Group Folder" is checked.
  3. Add the NearBee.frameworkm EddystoneScanner.framework and Socket.IO-Client-Swift.framework to the embedded binaries section of your destination app target.

  4. In Build Phases under destination app target, add the following frameworks in Link Binary With Libraries section:
    • CoreData.framework
    • SystemConfiguration.framework
    • CoreBluetooth.framework
    • CoreLocation.framework
    • EddystoneScanner.framework
    • NearBee.framework
    • Socket.IO-Client-Swift.framework

Configure your project

  1. In Info.plist, add a new fields, NSLocationAlwaysUsageDescription, NSLocationAlwaysAndWhenInUsageDescription, NSBluetoothPeripheralUsageDescription with relevant values that you want to show to the user. This is mandatory for iOS 10 and above.

  2. Enable Uses Bluetooth LE accessories in the Background Modes under Capabilities section.



The app should take care of handling the permissions as required by your set up to receive notifications on entring the beacon region.


The app should take care of enabling the bluetooth to range beacons.


The app should provide the developer token while initializing the SDK. Get it from Beaconstac Dashboard Account Page.


The app should provide the organization while initializing the SDK. Get it from Beaconstac Dashboard Account Page.

Monitoring Regions

If you are using the region monitoring API’s from advanced location manager, make sure it won’t affect the NearBee SDK.

Set Up

  1. In the app’s Info.plist add the below mentioned keys and the values

  1. Import the framework header in your class
import NearBee
import <NearBee/NearBee.h>
  1. Initialize NearBee using one-line initialization, the initialization starts scanning for beacons immediately.
var nearBee = NearBee.initNearBee()
NearBee *nearBee = [NearBee initNearBee];
  1. If you wish to control start and stop of scanning for beacons:
nearBee.startScanning() // Starts scanning for beacons...
nearBee.stopScanning() // Stops scanning for beacons...
[nearBee startScanning];
[nearBee stopScanning];
  1. Implement NearBeeDelegate protocol methods to show the beacons either in UITableView or UICollectionView
func didFindBeacons(_ beacons: [NearBeeBeacon]) {
    // Display Beacons

func didLoseBeacons(_ beacons: [NearBeeBeacon]) {
    // Display Beacons

func didUpdateBeacons(_ beacons: [NearBeeBeacon]) {
    // Display Beacons

func didThrowError(_ error: Error) {
    // Show Error

func didUpdateState(_ state: NearBeeState) {
    // Update UI based on state
- (void)didFindBeacons:(NSArray<NearBeeBeacon *> * _Nonnull)beacons {
    // Display Beacons

- (void)didLoseBeacons:(NSArray<NearBeeBeacon *> * _Nonnull)beacons {
    // Display Beacons

- (void)didUpdateBeacons:(NSArray<NearBeeBeacon *> * _Nonnull)beacons {
    // Display Beacons

- (void)didThrowError:(NSError * _Nonnull)error {
    // Error

- (void)didUpdateState(NearBeeState state) {
    // Update UI based on state
  1. Once user clicks on the notification, pass it to the NearBee SDK to display the notificaiton

// In the class where you want to listen to notification events...
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    let nearBeeInstance = NearBee.initNearBee()
    let isNearBeeNotification = nearBee.checkAndProcessNearbyNotification(response.notification)
    if (isNearBeeNotification) {
    } else {
        // Not a near bee notification, you need to handle

// In the class where you want to listen to notification events...
- (void)userNotificationCenter:(UNUserNotificationCenter *)center 
didReceiveNotificationResponse:(UNNotificationResponse *)response 
withCompletionHandler:(void (^)(void))completionHandler {
    NearBee *nearBeeInstance = [NearBee initNearBee];
    BOOL isNearBeeNotification = [nearBee checkAndProcessNearbyNotification:response.notification];
    if (isNearBeeNotification) {
    } else {
        // Not a near bee notification, you need to handle

Getting attachment data from the Beacon object

There are two types of attachments –


These are extracted from the physical web url of the beacon


PhysicalWeb properties

// Title

// Description

// Url for the icon

// Physical web url

// Returns if the url is currexntly active

// Title
[physicalWeb getTitle];

// Description
[physicalWeb getDescription];

// Url for the icon
[physicalWeb getIconURL];

// Physical web url
[physicalWeb getUrl];

// Returns if the url is currexntly active
[physicalWeb isActive];


This comes from Google Nearby attachment for a specific beacon

// returns a Set of ProximityAttachment objects

ProximityAttachment properties

In addition to all the properties from physical web, ProximityAttachment has extra properties

// Url for banner image

// Banner type, portrait = 1 or landscape = 2

// ISO code for the language

Convenience methods for getting attachments

Get the ProximityAttachment for the current device locale language.


Will return null if ProximityAttachment is not available for that language

[beacon getAttachmentForCurrentDeviceLanguage];

Returns a BeaconAttachment protocol confirmed object, which will be a ProximityAttachment if an attachment is found for the current language, or a PhysicalWeb otherwise

Will return null if no attachments are present for this beacon

[beacon getBestAvailableAttachment];

Getting business data from the Beacon object

Beacons may contain a Business object which is the Place associated with the beacon

let business =

They have following properties

// Color code associated with the place (Hex code), convert this accordingly

// Cover image url

// Google place id

// Place name

// Icon image url

Latest podspec

    "name": "NearBee",
    "swift_version": "5.0",
    "version": "2.0.0",
    "summary": "iOS library for Eddystone beacons",
    "homepage": "",
    "authors": {
        "MobStac Inc.": "[email protected]"
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "source": {
        "git": "",
        "tag": "v2.0.0"
    "xcconfig": {
    "vendored_frameworks": "NearBee/NearBee.framework",
    "dependencies": {
        "EddystoneScanner": [],
        "Socket.IO-Client-Swift": []
    "frameworks": [
    "requires_arc": true,
    "platforms": {
        "ios": "10.0"

Pin It on Pinterest

Share This