iossdk

更新时间：2020-06-23

HelloBaiduMap

引入头文件

Objective-C

Swift

// 引入base相关所有的头文件
#import <BaiduMapAPI_Base/BMKBaseComponent.h>

// 在桥接文件中引入头文件
#import <BaiduMapAPI_Base/BMKBaseComponent.h>

初始化BMKMapManager
在您的AppDelegate.m文件中添加对BMKMapManager的初始化，并填入您申请的授权AK（请确保此处AK与当前工程Bundle identifier匹配，否则会出现地图数据无法加载，只有方格的情况），示例如下：

Objective-C

Swift

- (BOOL)application:(UIApplication *)application   
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {       
    // 要使用百度地图，请先启动BaiduMapManager  
    BMKMapManager *mapManager = [[BMKMapManager alloc] init];   
    // 如果要关注网络及授权验证事件，请设定generalDelegate参数
    BOOL ret = [_mapManager start:@"在此处输入您的授权AK"  generalDelegate:nil];  
    if (!ret) {  
        NSLog(@"启动引擎失败");  
    }  
    return YES;  
}

class AppDelegate: UIResponder, UIApplicationDelegate, BMKGeneralDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 要使用百度地图，请先启动BMKMapManager
        let mapManager = BMKMapManager()
        // 启动引擎并设置AK并设置delegate
        if !(mapManager.start("在此处输入您的授权AK", generalDelegate: self)) {
            NSLog("启动引擎失败")
        }
        return true
    }
}

设置全局坐标系

全局设置地图SDK与开发者交互时的坐标类型。地图SDK默认使用BD09LL（BMK_COORDTYPE_BD09LL）坐标。如需使用GCJ02坐标，传入参数值为BMK_COORDTYPE_COMMON即可。本方法不支持传入WGS84（BMK_COORDTYPE_GPS）坐标。

开发者通过调用设置全局坐标方法（setCoordinateTypeUsedInBaiduMapSDK）设置的全局坐标类型后，意味着开发者和地图SDK约定传入和返回的坐标类型均为设置的类型;比如：定位传入的坐标，检索返回的坐标。

设置方法如下：

Objective-C

Swift

/**
 百度地图SDK所有API均支持百度坐标（BD09）和国测局坐标（GCJ02），用此方法设置您使用的坐标类型.
 默认是BD09（BMK_COORDTYPE_BD09LL）坐标.
 如果需要使用GCJ02坐标，需要设置CoordinateType为：BMK_COORDTYPE_COMMON.
 */
if ([BMKMapManager setCoordinateTypeUsedInBaiduMapSDK: BMK_COORDTYPE_COMMON]) {
    NSLog("经纬度类型设置成功");
} else {
    NSLog("经纬度类型设置失败")
}

/**
 百度地图SDK所有API均支持百度坐标（BD09）和国测局坐标（GCJ02），用此方法设置您使用的坐标类型.
 默认是BD09（BMK_COORDTYPE_BD09LL）坐标.
 如果需要使用GCJ02坐标，需要设置CoordinateType为：BMK_COORDTYPE_COMMON.
 */
if BMKMapManager.setCoordinateTypeUsedInBaiduMapSDK(BMK_COORD_TYPE.COORDTYPE_COMMON) {
    NSLog("经纬度类型设置成功")
} else {
    NSLog("经纬度类型设置失败")
}

注意：设置后请严格遵守约定，否则会出现经纬度与地图上展示的不一致的问题。为设置此项请确保传入坐标均为BD09LL（百度经纬度坐标）

创建BMKMapView

在您的ViewController.m文件中添加BMKMapView的创建代码，示例如下：

Objective-C

Swift

#import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相关所有的头文件
#import <BaiduMapAPI_Map/BMKMapComponent.h>//引入地图功能所有的头文件

@interface ViewController ()<BMKMapViewDelegate>
@property (nonatomic, strong) BMKMapView *mapView;
@end

@implementation ViewController
- (void)viewDidLoad {  
    [super viewDidLoad];  
    _mapView = [[BMKMapView alloc]initWithFrame:self.view.bounds]; 
    _mapView.delegate = self;
    [self.view addSubView:_mapView];      
}
@end

class ViewController: UIViewController, BMKMapViewDelegate {
    var mapView: BMKMapView?
    override func viewDidLoad() {
        super.viewDidLoad()
        mapView = BMKMapView(frame: self.view.frame)
        mapView?.delegate = self
        self.view.addSubview(mapView!);
    }
}

注意：BMKMapView使用viewWillAppear、viewWillDisappear方法来控制BMKMapView的生命周期，并且在一个时刻只能有一个BMKMapView接受回调消息，因此在使用BMKMapView的viewController中必须需要在viewWillAppear、viewWillDisappear方法中调用BMKMapView的对应的方法。

示例代码如下：

Objective-C

Swift

-(void)viewWillAppear:(BOOL)animated    
{    
    [super viewWillAppear:animated];
    [_mapView viewWillAppear];        
}    
-(void)viewWillDisappear:(BOOL)animated    
{
    [super viewWillDisappear:animated];
    [_mapView viewWillDisappear];
}

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    mapView?.viewWillAppear()
}
    
override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    mapView?.viewWillDisappear()
}

编译运行

效果如下图所示：

地图类型

地图类型及显示层级

百度地图SDK支持21级的地图显示，卫星图、热力图只支持显示到20级，放大至21级时将不再显示；交通路况图只支持显示到21级，放大至22级时将不再显示。各地图类型和图层支持层级说明如下表：

地图类型或图层类型	显示层级
2D地图	4-21级
3D地图	19-21级
卫星图	4-20级
路况交通图	7-21级
百度城市热力图	11-20级
室内图	17-22级

注：地图SDK自v4.0.0版本起，地图缩放等级由3-21变更为4-21，优化南北极地区展示效果。

1.设置缩放级别 BMKMapView设置级别示例代码如下：

Objective-C

Swift

// 将当前地图显示缩放等级设置为17级
[_mapView setZoomLevel:17];

// 将当前地图显示缩放等级设置为17级
mapView?.zoomLevel = 17

地图显示比例尺

百度地图SDK显示层级与比例尺对照表如下：

显示层级	比例尺/米
4	1000000
5	500000
6	200000
7	100000
8	50000
9	25000
10	20000
11	10000
12	5000
13	2000
14	1000
15	500
16	200
17	100
18	50
19	20
20	10
21	5

1.设置比例尺显示设置比例尺是否显示，默人为不显示，代码如下：

Objective-C

Swift

//显示比例尺
_mapView.showMapScaleBar = YES;
//隐藏比例尺
_mapView.showMapScaleBar = NO;

//显示比例尺
mapView?.showMapScaleBar = true
//隐藏比例尺
mapView?.showMapScaleBar = false

多实例地图显示

支持多实例显示地图，即开发者可以在一个页面中建立多个地图对象，并且针对这些对象分别操作且不会产生相互干扰。

创建两个BMKMapView

在当前控制器中展示两个BMKMapView，示例代码如下：

Objective-C

Swift

#import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相关所有的头文件
#import <BaiduMapAPI_Map/BMKMapComponent.h>//引入地图功能所有的头文件

@property (nonatomic, strong) BMKMapView *upsideMapView; //当前界面上方的mapView
@property (nonatomic, strong) BMKMapView *undersideMapView; //当前界面下方的mapView

_upsideMapView = [[BMKMapView alloc] initWithFrame:CGRectMake(0, 0, self.view.frame.size.width, (self.view.frame.size.height) / 2.0)];
_undersideMapView = [[BMKMapView alloc] initWithFrame:CGRectMake(0, (self.view.frame.size.height) / 2.0 + 10, self.view.frame.size.width, (self.view.frame.size.height) / 2.0 - 10)];

var upsideMapView: BMKMapView?
var undersideMapView: BMKMapView?

upsideMapView = BMKMapView(frame: CGRect.init(x: 0, y: 0, width: self.view.frame.width, height: self.view.frame.height / 2.0))
undersideMapView = BMKMapView(frame: CGRect.init(x: 0, y: self.view.frame.height / 2.0 + 10 , width: self.view.frame.width, height: self.view.frame.height / 2.0 - 10))

添加到当前的view上

Objective-C

Swift

//将upsideMapView添加到当前视图中
[self.view addSubview:_upsideMapView];
//将undersideMapView添加到当前视图中
[self.view addSubview:_undersideMapView];

self.view.addSubview(upsideMapView!);
self.view.addSubview(undersideMapView!);

分别设置delegate

Objective-C

Swift

//设置upsideMapView的代理
_upsideMapView.delegate = self;
//设置undersideMapView的代理
_undersideMapView.delegate = self;

upsideMapView?.delegate = self
undersideMapView?.delegate = self

分别管理mapView的生命周期

Objective-C

Swift

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    //当upsideMapView即将被显示的时候调用，恢复之前存储的upsideMapView状态
    [_upsideMapView viewWillAppear];
    //当undersideMapView即将被显示的时候调用，恢复之前存储的undersideMapView状态
    [_undersideMapView viewWillAppear];
}

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    //当upsideMapView即将被隐藏的时候调用，存储当前upsideMapView的状态
    [_upsideMapView viewWillDisappear];
    //当undersideMapView即将被隐藏的时候调用，存储当前undersideMapView的状态
    [_undersideMapView viewWillDisappear];
}

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    upsideMapView?.viewWillAppear()
    undersideMapView?.viewWillAppear()
}

override func viewWillDisappear(_ animated: Bool) {
    super.viewWillDisappear(animated)
    upsideMapView?.viewWillDisappear()
    undersideMapView?.viewWillAppear()
}

分别设置显示缩放级别

Objective-C

Swift

//设置upsideMapView的缩放等级
 [_upsideMapView setZoomLevel:17];
//设置undersideMapView的缩放等级
 [_undersideMapView setZoomLevel:20];

//设置upsideMapView的缩放等级
upsideMapView?.zoomLevel = 17
//设置undersideMapView的缩放等级
undersideMapView?.zoomLevel = 20

编译运行

效果如下图所示：

文档全面上新