一、周边雷达功能介绍
1，什么是周边雷达
（1）周边雷达功能，是面向移动端开发者的一套 SDK 功能接口（同步支持 Android 和 iOS 端）。
（2）周边雷达本质是一个连接百度 LBS 开放平台前端 SDK 产品和后端 LBS 云的中间服务。
2，使用场景
利用周边雷达功能，我们可以便捷的在自己的应用内，帮助用户实现查找周边跟“我”使用同一款 App 的人。比如：
（1）查看周边都有谁跟“我”使用同一个 App，分布在哪里？
（2）查看周边用户在听什么歌、看什么文章、有什么新动态？
（3）查看周边有什么最新发生的新闻、资讯？
二、准备工作
1，申请API Key
首先我们要到百度地图开放平台上申请个 API Key，供我们程序使用。具体参考我前面一篇文章：Swift - 百度地图SDK的配置和使用（附样例）
2，注册周边雷达
要使用周边雷达功能，我们光申请个 API Key 还不够。还需要对这个Key做相应的注册操作。
注册周边雷达是使用其相应功能的基础前提。通过注册可实现一个或多个应用之间的关系绑定，实现相互之间的位置信息查看。
3，集成SDK
周边雷达是百度地图SDK产品的一个功能模块。我们除了要将百度地图SDK的基础包集成进来外，还要集成周边雷达相关库（BaiduMapAPI_Radar.framework）。具体集成方式同样参考前文。
同时桥接头文件中也要将雷达库文件 import 进来。
#import <BaiduMapAPI_Base/BMKBaseComponent.h> //引入base相关所有的头文件
#import <BaiduMapAPI_Map/BMKMapComponent.h> //引入地图功能所有的头文件
#import <BaiduMapAPI_Map/BMKMapView.h> //只引入所需的单个头文件X
#import <BaiduMapAPI_Radar/BMKRadarComponent.h> //引入周边雷达功能所有的头文件
/****** 下面的几个暂时不需要 ******/
//#import <BaiduMapAPI_Search/BMKSearchComponent.h> //引入检索功能所有的头文件
//#import <BaiduMapAPI_Cloud/BMKCloudSearchComponent.h> //引入云检索功能所有的头文件
//#import <BaiduMapAPI_Location/BMKLocationComponent.h> //引入定位功能所有的头文件
//#import <BaiduMapAPI_Utils/BMKUtilsComponent.h> //引入计算工具所有的头文件
三、样例介绍
下面通过“附近的人”这个小样例演示周边雷达的使用。
（1）程序启动后，应用会自动定时上传用户位置信息（每隔5秒）
（2）上传位置的时候我们同时还附带上传用户名（随机生成的）
（3）主界面有个“附近的人”列表，显示500米范围内其他的用户，以及离你的距离（列表也是5秒钟刷新一次）。
（4）只用一台手机不太好看出效果。拿两台或以上数量的手机测试的话，就可以看到其他人信息，以及他们离你的距离。比如我这里用3部手机测试，其中1部手机的运行效果如下：
四、样例代码
1，info.plist
由于我们要使用 CoreLocation 获取实时位置数据，所以在 info.plist 里加入定位描述（Value 值为空也可以）：
NSLocationWhenInUseDescription ：允许在前台获取GPS的描述
NSLocationAlwaysUsageDescription ：允许在后台获取GPS的描述
2，AppDelegate.swift
在这里使用我们之前申请的授权 Key，来对 BMKMapManager 进行声明和初始化。
import UIKit
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, BMKGeneralDelegate {
var window: UIWindow?
var _mapManager: BMKMapManager?
func application(application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
_mapManager = BMKMapManager()
// 如果要关注网络及授权验证事件，请设定generalDelegate参数
let ret = _mapManager?.start("mRYTrHzAZUlT5Aojf5tMSxxxxxxxxxxx",
generalDelegate: self)
if ret == false {
NSLog("manager start failed!")
}
return true
}
//...............
3，ViewController.swift
位置信息上传、周边位置检索并显示等功能都在这里实现。这里要注意的是在上传和获取位置信息前，我们需要设置 userid。
如果我们不设置的话，这个也会自动生成的。自动生成的userid 是唯一的，且与当前设备有关。也就是说对于同一个设备每次启动程序后，生成的 userid 都是一样的。（所以多次关闭启动程序不会造成不断新增新用户的问题）
import UIKit
import CoreLocation
class ViewController: UIViewController, CLLocationManagerDelegate, BMKRadarManagerDelegate,
UITableViewDelegate, UITableViewDataSource {
//定位管理器
let locationManager:CLLocationManager = CLLocationManager()
//当前位置坐标
var currCoordinate:CLLocationCoordinate2D?
//周边雷达管理类
var _radarManager:BMKRadarManager?
//定时器，用于定时请求周边信息数据
var timer:NSTimer!
//周边用户集合
var infoList:[BMKRadarNearbyInfo] = [BMKRadarNearbyInfo]()
//显示周边用户的表格
var tableView:UITableView?
//当前用户名称
var userName:String!
override func viewDidLoad() {
super.viewDidLoad()
//随机生成一个用户名
userName = "陌生人\(String(format: "%03i", Int(arc4random()%1000)))"
self.title = "\(userName)，你好！下面是你周围的人。"
//设置定位服务管理器代理
locationManager.delegate = self
//设置定位进度
locationManager.desiredAccuracy = kCLLocationAccuracyBest
//更新距离
locationManager.distanceFilter = 100
////发送授权申请
locationManager.requestAlwaysAuthorization()
if (CLLocationManager.locationServicesEnabled()){
//允许使用定位服务的话，开启定位服务更新
locationManager.startUpdatingLocation()
print("定位开始")
}
//获取周边雷达管理类实例
_radarManager = BMKRadarManager.getRadarManagerInstance()
//在上传和拉取位置信息前，需要设置userid，否则会自动生成
//_radarManager?.userId = "u007"
//通过添加radar delegate获取自动上传时的位置信息，以及获得雷达操作结果
_radarManager?.addRadarManagerDelegate(self)
//位置信息连续自动上传（每隔5秒上传一次）
_radarManager?.startAutoUpload(5)
//启用计时器，控制每5秒执行一次requestNearbyData方法，请求周边信息
timer = NSTimer.scheduledTimerWithTimeInterval(5,
target:self,selector:#selector(ViewController.requestNearbyData),
userInfo:nil,repeats:true)
//创建表视图
self.tableView = UITableView(frame: self.view.frame, style:UITableViewStyle.Plain)
self.tableView!.delegate = self
self.tableView!.dataSource = self
//创建一个重用的单元格
self.tableView!.registerClass(UITableViewCell.self,
forCellReuseIdentifier: "SwiftCell")
self.view.addSubview(self.tableView!)
}
//定位改变执行，可以得到新位置、旧位置
func locationManager(manager: CLLocationManager,
didUpdateLocations locations: [CLLocation]) {
//获取最新的坐标
currCoordinate = locations.last!.coordinate
}
//获取我的位置信息（自动上传调用）
func getRadarAutoUploadInfo() -> BMKRadarUploadInfo! {
if let pt = currCoordinate{
let myinfo = BMKRadarUploadInfo()
myinfo.extInfo = userName
//myinfo.pt = CLLocationCoordinate2DMake(39.916, 116.404)
myinfo.pt = pt
return myinfo
}else{
return nil
}
}
//返回雷达 上传结果
func onGetRadarUploadResult(error: BMKRadarErrorCode) {
if error == BMK_RADAR_NO_ERROR {
print("位置上传成功")
}else{
print("位置上传失败")
}
}
//发起检索请求，获取周边信息
func requestNearbyData() {
if let centerPt = currCoordinate {
let option = BMKRadarNearbySearchOption()
option.radius = 500 //检索半径
option.sortType = BMK_RADAR_SORT_TYPE_DISTANCE_FROM_NEAR_TO_FAR //排序方式
option.centerPt = centerPt //检索中心点
//发起检索
let res = _radarManager?.getRadarNearbySearchRequest(option)
if res! {
print("周边信息获取成功")
} else {
print("周边信息获取失败")
}
}
}
//获取到周边位置信息回调
func onGetRadarNearbySearchResult(result: BMKRadarNearbyResult!, error: BMKRadarErrorCode) {
if error == BMK_RADAR_NO_ERROR {
print("周边用户数量：",result.totalNum)
self.infoList = result.infoList as! [BMKRadarNearbyInfo]
self.tableView?.reloadData()
}
}
//在本例中，只有一个分区
func numberOfSectionsInTableView(tableView: UITableView) -> Int {
return 1;
}
//返回表格行数（也就是返回控件数）
func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return self.infoList.count
}
//创建各单元显示内容(创建参数indexPath指定的单元）
func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath)
-> UITableViewCell {
let cell = UITableViewCell(style: UITableViewCellStyle.Value1,
reuseIdentifier: "SwiftCell")
cell.textLabel?.text = self.infoList[indexPath.row].extInfo
cell.detailTextLabel?.text = "\(self.infoList[indexPath.row].distance)m"
return cell
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}