baidumap demo(一)

覆盖物概述

地图上自定义的标注点和覆盖物我们统称为地图覆盖物。您可以通过定制BMKAnnotation和BMKOverlay来添加对应的标注点和覆盖物。地图覆盖物的设计遵循数据与View分离的原则，BMKAnnotation和BMKOverlay系列的类主要用来存放覆盖物相关的数据，BMKAnnotaionView和BMKOverlayView系列类为覆盖物对应的View。

SDK支持画点、折线、圆、多边形（包括凹凸两种）、图片图层和自定义覆盖物。从2.0.0开始矢量地图采用OpenGL绘制，新增支持OpenGL绘制的基本线绘制、面绘制接口。详见AnnotationDemo，SDK内置的BMKPolylineOverlay、BMKPolygonOverlay，BMKCircleOverlay均采用OpenGL绘制。

添加标注

BMKAnnotation为标注对应的protocal，您可以自定义标注类实现该protocal。百度地图API也预置了基本的标注点——BMKPointAnnotation和一个大头针标注View——BMKPinAnnotationView，您可以直接使用来显示标注。示例如下：
修改您的ViewController.h文件，添加以下代码，使您的ViewController实现BMKMapViewDelegate协议：

源码复制打印关于

#import <UIKit/UIKit.h>
#import "BMapKit.h"
@interface AnnotationDemoViewController : UIViewController <BMKMapViewDelegate> {
IBOutlet BMKMapView* mapView;
}
@end

修改您的ViewController.m文件，实现BMKMapViewDelegate的mapView:viewForAnnotation:函数，并在viewDidAppear添加标注数据对象

源码复制打印关于

- (void) viewDidAppear:(BOOL)animated {
// 添加一个PointAnnotation
BMKPointAnnotation* annotation = [[BMKPointAnnotation alloc]init];
CLLocationCoordinate2D coor;
coor.latitude = 39.915;
coor.longitude = 116.404;
annotation.coordinate = coor;
annotation.title = @"这里是北京";
[mapView addAnnotation:annotation];
}
// Override
- (BMKAnnotationView *)mapView:(BMKMapView *)mapView viewForAnnotation:(id <BMKAnnotation>)annotation
{
if ([annotation isKindOfClass:[BMKPointAnnotation class]]) {
BMKPinAnnotationView *newAnnotationView = [[BMKPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:@"myAnnotation"];
newAnnotationView.pinColor = BMKPinAnnotationColorPurple;
newAnnotationView.animatesDrop = YES;// 设置该标注点动画显示
return newAnnotationView;
}
return nil;
}

运行后，会在地图显示对应的标注点，点击会弹出气泡，效果如图：

删除标注

通过removeAnnotation:函数实现对已添加标注的删除功能，示例如下：

源码复制打印关于

if (annotation != nil) {
[_mapView removeAnnotation:annotation];
}

添加折线

修改您的ViewController.h文件，添加以下代码，使您的ViewController实现BMKMapViewDelegate协议：

源码复制打印关于

#import <UIKit/UIKit.h>
#import "BMapKit.h"
@interface OverlayDemoViewController : UIViewController <BMKMapViewDelegate>{
IBOutlet BMKMapView* mapView;
}
@end

修改您的ViewController.m文件，实现BMKMapViewDelegate的mapView:viewForOverlay:函数，并在viewDidLoad添加折线数据对象：

源码复制打印关于

- (void)viewDidLoad {
[super viewDidLoad];
// 添加折线覆盖物
CLLocationCoordinate2D coors[2] = {0};
coors[0].latitude = 39.315;
coors[0].longitude = 116.304;
coors[1].latitude = 39.515;
coors[1].longitude = 116.504;
BMKPolyline* polyline = [BMKPolyline polylineWithCoordinates:coors count:2];
[_mapView addOverlay:polyline];
}
// Override
- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id <BMKOverlay>)overlay{
if ([overlay isKindOfClass:[BMKPolyline class]]){
BMKPolylineView* polylineView = [[[BMKPolylineView alloc] initWithOverlay:overlay] autorelease];
polylineView.strokeColor = [[UIColor purpleColor] colorWithAlphaComponent:1];
polylineView.lineWidth = 5.0;
return polylineView;
}
return nil;
}

运行后，效果如图：

添加弧线

百度地图iOS SDK自v2.1.1版本起，新增了绘制弧线的方法。用户可以根据三个有序点唯一确定一条弧线，满足您的业务需求。首先，修改您的.m文件，实现BMKMapViewDelegate的mapView:viewForOverlay:函数，并在viewDidLoad添加弧线数据对象：

源码复制打印关于

- (void)viewDidLoad {
[super viewDidLoad];
//添加弧线覆盖物
//传入的坐标顺序为起点、途经点、终点
CLLocationCoordinate2D coords[3] = {0};
coords[0].latitude = 39.9374;
coords[0].longitude = 116.350;
coords[1].latitude = 39.9170;
coords[1].longitude = 116.360;
coords[2].latitude = 39.9479;
coords[2].longitude = 116.373;
BMKArcline *arcline = [BMKArcline arclineWithCoordinates:coords];
[_mapView addOverlay:arcline];
}
//根据overlay生成对应的View
- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id<bmkoverlay>)overlay
{
if ([overlay isKindOfClass:[BMKArcline class]])
{
BMKArclineView* arclineView = [[[BMKArclineView alloc] initWithOverlay:overlay] autorelease];
arclineView.strokeColor = [[UIColor blueColor] colorWithAlphaComponent:0.5];
arclineView.lineWidth = 5.0;
return arclineView;
}
return nil;
}
</bmkoverlay>

运行后，效果如图：

添加多边形

修改您的ViewController.h文件，添加以下代码，使您的ViewController实现BMKMapViewDelegate协议：
修改您的ViewController.m文件，实现BMKMapViewDelegate的mapView:viewForOverlay:函数，并在viewDidLoad添加多边形数据对象：

源码复制打印关于

- (void)viewDidLoad {
[super viewDidLoad];
// 添加多边形覆盖物
CLLocationCoordinate2D coords[3] = {0};
coords[0].latitude = 39;
coords[0].longitude = 116;
coords[1].latitude = 38;
coords[1].longitude = 115;
coords[2].latitude = 38;
coords[2].longitude = 117;
BMKPolygon* polygon = [BMKPolygon polygonWithCoordinates:coords count:3];
[mapView addOverlay:polygon];
}
// Override
- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id <BMKOverlay>)overlay{
if ([overlay isKindOfClass:[BMKPolygon class]]){
BMKPolygonView* polygonView = [[[BMKPolygonView alloc] initWithOverlay:overlay] autorelease];
polygonView.strokeColor = [[UIColor purpleColor] colorWithAlphaComponent:1];
polygonView.fillColor = [[UIColor cyanColor] colorWithAlphaComponent:0.2];
polygonView.lineWidth = 5.0;
return polygonView;
}
return nil;
}

运行后，效果如图：

添加圆

源码复制打印关于

- (void)viewDidLoad {
[super viewDidLoad];
// 添加圆形覆盖物
CLLocationCoordinate2D coor;
coor.latitude = 39.915;
coor.longitude = 116.404;
BMKCircle* circle = [BMKCircle circleWithCenterCoordinate:coor radius:5000];
[_mapView addOverlay:circle];
}
// Override
- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id <BMKOverlay>)overlay{
if ([overlay isKindOfClass:[BMKCircle class]]){
BMKCircleView* circleView = [[[BMKCircleView alloc] initWithOverlay:overlay] autorelease];
circleView.fillColor = [[UIColor cyanColor] colorWithAlphaComponent:0.5];
circleView.strokeColor = [[UIColor blueColor] colorWithAlphaComponent:0.5];
circleView.lineWidth = 10.0;
return circleView;
}
return nil;
}

运行后，效果如图：

添加图片图层

自V2.1.0开始，新增图片图层，开发者可在地图的指定位置上添加图片。该图片可随地图的平移、缩放、旋转等操作做相应的变换。图片图层是一种特殊的Overlay，它位于底图和底图标注层之间（即图片图层不会遮挡地图标注信息），此外，图片图层的添加顺序不会影响其他图层（例如：POI搜索图层、我的位置图层等）的叠加关系。

图片图层对象初始化的方法有两种：1）根据指定经纬度坐标生成 2）根据指定区域生成。下面举例分步说明添加图片图层的步骤：

修改您的ViewController.h文件，添加以下代码，使您的ViewController实现BMKMapViewDelegate协议：

源码复制打印关于

@interface AnnotationDemoViewController : UIViewController<BMKMapViewDelegate>{
IBOutlet BMKMapView* _mapView;
}
@end

修改您的ViewController.m文件，在viewDidLoad添加图片图层对象：

源码复制打印关于

- (void)viewDidLoad {
[super viewDidLoad];
//添加图片图层覆盖物(第一种:根据指定经纬度坐标生成)
CLLocationCoordinate2D coors;
coors.latitude = 39.800;
coors.longitude = 116.404;
BMKGroundOverlay* ground = [BMKGroundOverlay groundOverlayWithPosition:coors
zoomLevel:11 anchor:CGPointMake(0.0f,0.0f)
icon:[UIImage imageWithName:@"test.png"]];
[_mapView addOverlay:ground];
//添加图片图层覆盖物(第二种:根据指定区域生成)
CLLocationCoordinate2Dcoords[2] = {0};
coords[0].latitude = 39.815;
coords[0].longitude = 116.404;
coords[1].latitude = 39.915;
coords[1].longitude = 116.504;
BMKCoordinateBounds bound;
bound.southWest = coords[0];
bound.northEast = coords[1];
BMKGroundOverlay* ground2 = [BMKGroundOverlay groundOverlayWithBounds: bound
icon:[UIImage imageWithName:@"test.png"]];
[_mapView addOverlay:ground2];
}

修改您的ViewController.m文件，实现BMKMapViewDelegate的mapView:viewForOverlay:函数：

源码复制打印关于

- (BMKOverlayView *)mapView:(BMKMapView *)mapView viewForOverlay:(id<BMKOverlay>)overlay{
if ([overlay isKindOfClass:[BMKGroundOverlay class]]){
BMKGroundOverlayView* groundView = [[[BMKGroundOverlayView alloc] initWithOverlay:overlay] autorelease];
return groundView;
}
return nil;
}

运行后，效果如图：

2D效果图3D效果图

添加自定义Overlay

从2.0.0开始，地图渲染采用OpenGL方式实现，因此覆盖物基类BMKOverlayView新增glRender接口，以及绘制基本线renderLinesWithPoints、面renderRegionWithPoints的接口来实现对覆盖物的OpenGL渲染。绘制自定义overlay时，继承BMKOverlayView的子类需实现glRender接口，在glRender中通过调用renderLinesWithPoints、renderRegionWithPoints来组合自己想要实现的图形，示例代码如下，详细示例请参见CustomOverlayDemoViewController：

CustomOverlayView继承BMKOverlayPathView，在CustomOverlayView中实现glRender

源码复制打印关于

- (void)glRender {
//自定义overlay绘制
CustomOverlay *customOverlay = [self customOverlay];
if (customOverlay.pointCount >= 3) {
[self renderRegionWithPoints:customOverlay.points pointCount:customOverlay.pointCount fillColor:self.fillColor usingTriangleFan:YES];//绘制多边形
}else
{
[self renderLinesWithPoints:customOverlay.points pointCount:customOverlay.pointCount strokeColor:self.strokeColor lineWidth:self.lineWidth looped:NO];//绘制线
}
}

如果不实现glRender，则需实现drawMapRect默认使用系统GDI绘制，GDI绘制方式在overlayView尺寸较大时可能有效率问题，因此建议使用glRender来实现自定义overlay绘制。

删除Overlay

通过removeOverlay:函数实现对已添加标注的删除功能，示例如下：

源码复制打印关于

if (overlay != nil) {
[_mapView removeOverlay:overlay];
}