现在的APP中几乎都会用到地图,关于地图集成,在这里以百度地图为例,总结一点方法,我们公司用到比较简单,自己有参考了一些大神写的demo,根据文档写点东西,希望帮到大家.
1.准备工作
创建项目后,先去百度地图开放平台上,注册一个应用,拿到AppKey.具体操作很简单,不赘述.还有关于百度地图的介绍以及功能,自己看文档,没什么好说的,也不赘述.(注意:申请应用的时候不要带敏感词汇,buddle id不要写错)
2.配置环境
可以用CocoaPods直接安装,比较简单:
pod 'BaiduMapKit' #百度地图SDK
pod install (这个可能比较慢,请耐心等待……)
手动配置的时候,比较麻烦.先去百度地图官方平台上下载对应的SDK包,然后导入对应的文件到你的项目中去.具体步骤不赘述,简单说几点:1.静态库是采用ObjectC++实现的,因此至少要保证你的工程中有一个.mm后缀的源文件.2.:mapapi.bundle不要忘了导入;
info.plist中需要进行的几个操作:iOS9以后https协议的设置,获取地理位置的设置;display name的设置(Xcode6)
百度官方关于手动导入的文档,点击进入
在导入头文件的时候经常出错,主要是太多了,自己又不熟悉.现在把所有的头文件写在下面,根据需要复制粘贴即可.
#import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相关所有的头文件
#import <BaiduMapAPI_Map/BMKMapComponent.h>//引入地图功能所有的头文件
#import <BaiduMapAPI_Search/BMKSearchComponent.h>//引入检索功能所有的头文件
#import <BaiduMapAPI_Cloud/BMKCloudSearchComponent.h>//引入云检索功能所有的头文件
#import <BaiduMapAPI_Location/BMKLocationComponent.h>//引入定位功能所有的头文件
#import <BaiduMapAPI_Utils/BMKUtilsComponent.h>//引入计算工具所有的头文件
#import <BaiduMapAPI_Radar/BMKRadarComponent.h>//引入周边雷达功能所有的头文件
#import <BaiduMapAPI_Map/BMKMapView.h>//只引入所需的单个头文件
3.基本地图的实现,这里比较简单,我直接抄的别人的.
在APPdelegate中导入头文件 #import<BaiduMapAPI_Base/BMKMapManager.h>,并且遵守BMKGeneralDelegate代理,在类扩展中实现
@property (nonatomic, strong) BMKMapManager *mapManager;
在didFinishLaunchingWithOptions方法中实现如下代码
_mapManager = [[BMKMapManager alloc] init];
BOOL ret = [_mapManager start:@"你的key"generalDelegate:self];
if (!ret) {
NSLog(@"manager start failed!");
}
return YES;
早viewController中,遵循BMKMapViewDelegate代理
//遵循代理写在viewwillappear中
- (void)viewWillAppear:(BOOL)animated {
[_mapView viewWillAppear];
_mapView.delegate = self;
_locService.delegate = self;
_geoCodeSearch.delegate = self;
}
- (void)viewWillDisappear:(BOOL)animated {
[_mapView viewWillDisappear];
_mapView.delegate = nil;
_locService.delegate = nil;
_geoCodeSearch.delegate = nil;
}
在viewdidload中,创建地图
_mapView = [[BMKMapView alloc] initWithFrame:CGRectMake(0, 100, self.view.frame.size.width, self.view.frame.size.height - 100)];
[self.view addSubview:_mapView];
这时地图可以展示出来.下面开始实现功能.
4.地图定位
UIButton *positionBtn = [UIButton buttonWithType:UIButtonTypeSystem];
positionBtn.frame = CGRectMake(30, 64, 70, 20);
[positionBtn setTitle:@"定位" forState:UIControlStateNormal];
[positionBtn addTarget:self action:@selector(position:) forControlEvents:UIControlEventTouchUpInside];
[self.view addSubview:positionBtn];
遵循BMKLocationServiceDelegate代理,定义BMKLocationService类在定位按钮点击方法中:
_locService.delegate = self;
_mapView.zoomLevel = 14.1; //地图等级,数字越大越清晰
_mapView.showsUserLocation = NO;//是否显示定位小蓝点,no不显示,我们下面要自定义的(这里显示前提要遵循代理方法,不可缺少)
_mapView.userTrackingMode = BMKUserTrackingModeNone;
//定位
[_locService startUserLocationService];
定位代理方法-(void)didUpdateBMKUserLocation:(BMKUserLocation *)userLocation
在这个方法中,定位的时候能获取到经纬度:userLocation.location.coordinate
这个时候点击地图是没有反应的,因为我们没有设置地图的中心点
_mapView.centerCoordinate = userLocation.location.coordinate(如果直接写在代理方法中,需要在代理方法末尾调用[_locService stopUserLocationService] 方法,让定位停止,要不然一直定位,你的地图就一直锁定在一个位置)。
当然,如果想要动画的时候可以这样写:
[_mapView setCenterCoordinate:userLocation.location.coordinate animated:YES];
然后就可以定位了,地图上出现一个蓝色的小点,这个时候可以窃喜一会了,但是在我们项目中,很少用系统的定位图片,大多需要用我们自己设计的图片.
接下来我们进行自定义标注.
讲标注之前,需要弄懂两个类的区别:BMKPointAnnotation和BMKAnnotionView,很多刚接地图的都弄不清楚,前者讲的是一个点的标注,后者讲的是标注视图,好像还是不清楚.按照大神的理解:前者代表一个点,比如地图上有很多的红色的大头针,大头针往那里一插,是不是有个点?这个点就表示BMKPointAnnotation,具有地理的经纬度特性(其他的一些信息也乐意写在这里面,如果后台将一系列信息包括经纬度信息传给你的话,你就可以重写这个类).BMKAnnotationView则代表这个红色的大头针,是的,红色的大头针不好看,想要换成德玛西亚的巨剑,可以,直接在这个NMKAnnotationView内部添加image即可,现在是不是明白了.下面我们代码走起.
首先及诶绝一个问题,系统蓝色定位的小圆点不好看,我们给它换掉.
(1).对BMKPointAnnotation操作,上面定位获取地理位置的代理方法中:
_pointAnnotation = [[BMKPointAnnotation alloc] init];
_pointAnnotation.coordinate = userLocation.location.coordinate;
_pointAnnotation.title = @"我在这个地方";
_pointAnnotation.subtitle = @"你在哪呢";
[_mapView addAnnotation:_pointAnnotation];
[_mapView selectAnnotation:_pointAnnotation animated:YES];
(2)对BMKAnnotationView操作,新建一个类继承与BMKAnnotationView,在.h中声明一个属性
@property (nonatomic, strong) UIImageView *bgImageView;
在.m中重写init方法
- (id)initWithAnnotation:(id<BMKAnnotation>)annotation reuseIdentifier:(NSString *)reuseIdentifier{
self = [super initWithAnnotation:annotation reuseIdentifier:reuseIdentifier];
if (self) {
self.backgroundColor = [UIColor colorWithWhite:0 alpha:0];
self.centerOffset = CGPointMake(0, 0);
//定义改标注总的大小
self.frame = CGRectMake(0, 0, 39, 39);
_bgImageView = [[UIImageView alloc] initWithFrame:self.frame];
_bgImageView.image = [UIImage imageNamed:@"iconsend.png"];
[self addSubview:_bgImageView];
}
return self;
}
(3)生成对应气泡时候出发的方法
- (BMKAnnotationView *)mapView:(BMKMapView *)mapView viewForAnnotation:(id<BMKAnnotation>)annotation {
//if ([annotation isKindOfClass:[BMKPointAnnotation class]]) //判断是哪个BMKPointAnnotation
MyAnnotionView *newAnnotationView = (MyAnnotionView *)[mapView dequeueReusableAnnotationViewWithIdentifier:myLocationViewID];
if (newAnnotationView == nil) {
newAnnotationView = [[MyAnnotionView alloc] initWithAnnotation:annotation reuseIdentifier:myLocationViewID];
}
return newAnnotationView;
}
如图:
图1
自定义的标注完成,自定义气泡呢?这个涉及到一个paopaoView,也就是BMKAnnotationView内部的一个属性,它就是点击触发的气泡视图.
在上面的(2)方法中,添加一段paopaoView代码.
- (id)initWithAnnotation:(id<BMKAnnotation>)annotation reuseIdentifier:(NSString *)reuseIdentifier{
self = [super initWithAnnotation:annotation reuseIdentifier:reuseIdentifier];
if (self) {
self.backgroundColor = [UIColor colorWithWhite:0 alpha:0];
self.centerOffset = CGPointMake(0, 0);
self.frame = CGRectMake(0, 0, 39, 39);
_bgImageView = [[UIImageView alloc] initWithFrame:self.frame];
_bgImageView.image = [UIImage imageNamed:@"iconsend.png"];
[self addSubview:_bgImageView];
UIImageView *paoView = [[UIImageView alloc] initWithFrame:CGRectMake(0, 0, 30, 30)];
paoView.image =[UIImage imageNamed:@"iconsend.png"];
self.paopaoView = [[BMKActionPaopaoView alloc] initWithCustomView:paoView];
}
return self;
}
还有我们什么时候重写BMKPointAnnotation呢,一般来说他只是传个地理位置信息,当我们在地图上想要显示多个地理位置信息的时候,比如后台返回来一个数组,里面每个元素都是一个字典,每个字典代表一个单位,除了地理位置信息,还有其他信息,比如名字,图片等,对应的是每个地理位置,这时候重写BMKPointAnnotation,并在其中定义一个model属性,用来接收后台返回来的model信息串.然后声明这个pointAnnotation类的对象,并给他赋值后台返回来的model信息串中的位置信息,并将整个model传给它,后面的操作和上面的一样.
5.POI检索
我们先定义一个输入框,然后根据输入的文字来大概的地址
UITextField *poiTextField = [[UITextField alloc] initWithFrame:CGRectMake(30, 30, 100, 20)];
poiTextField.backgroundColor = [UIColor lightGrayColor];
[poiTextField addTarget:self action:@selector(valueChange:) forControlEvents:UIControlEventEditingChanged];
poiTextField.delegate = self;
[self.view addSubview:poiTextField];
- (void)valueChange:(UITextField *)textField {
NSLog(@"123");
_poiSearch = [[BMKPoiSearch alloc] init];
_poiSearch.delegate = self;
NSLog(@"搜索:%@",textField.text);
//附近云检索
BMKNearbySearchOption *nearBySearchOption = [[BMKNearbySearchOption alloc] init];
nearBySearchOption.pageIndex = 0;
nearBySearchOption.pageCapacity = 10;
nearBySearchOption.keyword = textField.text;
//检索的中心点
nearBySearchOption.location = _locService.userLocation.location.coordinate;
nearBySearchOption.radius = 100;
BOOL flag = [_poiSearch poiSearchNearBy:nearBySearchOption];
if (flag) {
NSLog(@"success");
} else {
NSLog(@"fail");
}
}
在返回的代理方法中,我们打印一下:
- (void)onGetPoiResult:(BMKPoiSearch *)searcher result:(BMKPoiResult *)poiResult errorCode:(BMKSearchErrorCode)errorCode {
if (errorCode == BMK_SEARCH_NO_ERROR) {
for (int i = 0; i < poiResult.poiInfoList.count; i++) {
BMKPoiInfo *info = [poiResult.poiInfoList objectAtIndex:i];
NSLog(@"地址:%@", info.name);
}
}
}
效果如下:
图3
是不是得到我们要的数据了呢,然后把这些数据显示到tableView上,是不是就像我们常见的搜索框搜索了,得到了对应的结果.
6.地理反编码
地理反编码的应用一般是移动地图,然后显示附近的地理信息(我们常见的APP上这个功能一般是和poi搜索配合使用的)
声明变量.遵循代理方法
@property (nonatomic, strong) BMKGeoCodeSearch *geoCodeSearch;
移动地图的代理方法
- (void)mapView:(BMKMapView *)mapView regionDidChangeAnimated:(BOOL)animated {
CLLocationCoordinate2D carLocation = [_mapView convertPoint:self.view.center toCoordinateFromView:self.view];
BMKReverseGeoCodeOption *option = [[BMKReverseGeoCodeOption alloc] init];
option.reverseGeoPoint = CLLocationCoordinate2DMake(carLocation.latitude, carLocation.longitude);
NSLog(@"%f - %f", option.reverseGeoPoint.latitude, option.reverseGeoPoint.longitude);
//调用发地址编码方法,让其在代理方法onGetReverseGeoCodeResult中输出
[_geoCodeSearch reverseGeoCode:option];
}
//返回地理反编码
- (void)onGetReverseGeoCodeResult:(BMKGeoCodeSearch *)searcher result:(BMKReverseGeoCodeResult *)result errorCode:(BMKSearchErrorCode)error {
if (result) {
NSLog(@"%@ - %@ - %@ - %@ - %@", result.addressDetail.province, result.addressDetail.city, result.addressDetail.streetName, result.address, result.businessCircle);
} else {
NSLog(@"找不到");
}
}
当然,如果想配合着poi使用,只需要把result.poiList数据源存储到数组中,然后tableView中显示出来. ......
7.路径规划
将目的地和初始地点连接起来,通过百度内部API来告诉我们怎么走(也就是去一个地方查地图一样)
首先导入<BaiduMapAPI_Search/BMKRouteSearch.h>
<BaiduMapAPI_Utils/BMKUtilsComponent.h>这两个头文件,并遵循代理BMKRouteSearchDelegate代理.
在.m文件最上面,我们还要声明一个PointAnnotation类,代码如下:
@interface RouteAnnotation : BMKPointAnnotation
{
int _type; //0:起点 1:终点 2:公交 3:地铁 4:驾乘 5:途经点
int _degree;
}
@property (nonatomic) int type;
@property (nonatomic) int degree;
@end
@implementation RouteAnnotation
@synthesize type = _type;
@synthesize degree = _degree;
@end
同时,我们定义一个属性.
@property (nonatomic, strong) BMKRouteSearch *routeSearch;
在button点击方法里面实现下面的代码
- (void)PlanBtn:(UIButton *)btn {
_routeSearch = [[BMKRouteSearch alloc] init];
_routeSearch.delegate = self;
//发起检索
BMKPlanNode *start = [[BMKPlanNode alloc] init];
start.name = @"国贸";
BMKPlanNode *end = [[BMKPlanNode alloc] init];
end.name = @"国家体育总局";
BMKTransitRoutePlanOption *transiRouteS = [[BMKTransitRoutePlanOption alloc] init];
transiRouteS.city = @"北京市";
transiRouteS.from = start;
transiRouteS.to = end;
BOOL flag = [_routeSearch transitSearch:transiRouteS];
if (flag) {
NSLog(@"transtion检索发送成功");
} else {
NSLog(@"fail");
}
}
在上面的代码中,我们用的是BMKTransitRoutePlanOption,也就是公交(地铁)方式,如果你想用别的方式,比如:步行,骑行,驾车等,可以在这里替换.
因为上面我们用的是公交,所以下面我们要实现公交的代理方法,每一种出行方式都有自己的代理方法
- (void)onGetTransitRouteResult:(BMKRouteSearch *)searcher result:(BMKTransitRouteResult *)result errorCode:(BMKSearchErrorCode)error {
if (error == BMK_SEARCH_NO_ERROR) {
//在此处理正常结果
BMKTransitRouteLine* plan = (BMKTransitRouteLine*)[result.routes objectAtIndex:0];
NSInteger size = [plan.steps count];
NSLog(@"size == %ld", (long)size);
int planPointCounts = 0;
for (int i = 0; i < size; i++) {
BMKTransitStep *tansitStep = [plan.steps objectAtIndex:i];
if (i == 0 ) {
RouteAnnotation *item = [[RouteAnnotation alloc] init];
item.coordinate = plan.starting.location;
item.title = @"起点";
item.type = 0;
[_mapView addAnnotation:item]; //添加起点标注
} else if (i == size - 1) {
RouteAnnotation *item = [[RouteAnnotation alloc] init];
item.coordinate = plan.terminal.location;
item.title = @"终点";
item.type = 1;
[_mapView addAnnotation:item];
}
RouteAnnotation *item = [[RouteAnnotation alloc] init];
item.coordinate = tansitStep.entrace.location; //路段入口信息
item.title = tansitStep.instruction; //路程换成说明
item.type = 3;
[_mapView addAnnotation:item];
//轨迹点总数累计
planPointCounts += tansitStep.pointsCount;
}
//轨迹点
BMKMapPoint * temppoints = new BMKMapPoint[planPointCounts]; //文件后缀名改为mm
int i = 0;
for (int j = 0; j < size; j++) {
BMKTransitStep *transitStep = [plan.steps objectAtIndex:j];
int k = 0;
for (k = 0; k < transitStep.pointsCount; k++) {
temppoints[i].x = transitStep.points[k].x;
temppoints[i].y = transitStep.points[k].y;
i++;
}
}
//通过points构建BMKPolyline
BMKPolyline *polyLine = [BMKPolyline polylineWithPoints:temppoints count:planPointCounts];
[_mapView addOverlay:polyLine]; //添加路线overlay
delete []temppoints;
[self mapViewFitPolyLine:polyLine];
}
else if (error == BMK_SEARCH_AMBIGUOUS_ROURE_ADDR){
//当路线起终点有歧义时通,获取建议检索起终点
//result.routeAddrResult
}
else {
NSLog(@"抱歉,未找到结果");
}
在上面结尾那里我们 添加了路线overlay,所以我们要实现overlay的代理方法
- (BMKOverlayView*)mapView:(BMKMapView *)map viewForOverlay:(id<BMKOverlay>)overlay{
if ([overlay isKindOfClass:[BMKPolyline class]]) {
BMKPolylineView* polylineView = [[BMKPolylineView alloc] initWithOverlay:overlay];
polylineView.fillColor = [[UIColor alloc] initWithRed:0 green:1 blue:1 alpha:1];
polylineView.strokeColor = [[UIColor alloc] initWithRed:0 green:0 blue:1 alpha:0.7];
polylineView.lineWidth = 3.0;
return polylineView;
}
return nil;
}
在这里,你可以根据自己的需要改变线条的一些属性.
把下面这段代码复制到工程里,这是百度给我们写好的根据路径计算地图范围的,挺好的.直接用他们的.
- (void)mapViewFitPolyLine:(BMKPolyline *) polyLine {
CGFloat ltX, ltY, rbX, rbY;
if (polyLine.pointCount < 1) {
return;
}
BMKMapPoint pt = polyLine.points[0];
ltX = pt.x, ltY = pt.y;
rbX = pt.x, rbY = pt.y;
for (int i = 1; i < polyLine.pointCount; i++) {
BMKMapPoint pt = polyLine.points[i];
if (pt.x < ltX) {
ltX = pt.x;
}
if (pt.x > rbX) {
rbX = pt.x;
}
if (pt.y > ltY) {
ltY = pt.y;
}
if (pt.y < rbY) {
rbY = pt.y;
}
}
BMKMapRect rect;
rect.origin = BMKMapPointMake(ltX , ltY);
rect.size = BMKMapSizeMake(rbX - ltX, rbY - ltY);
[_mapView setVisibleMapRect:rect];
_mapView.zoomLevel = _mapView.zoomLevel - 0.3;
}
由于我们在公交的代理方法中添加了标注,所以我们要在标注的代理方法中实现我们自定义的标注.
if ([annotation isKindOfClass:[RouteAnnotation class]]) {
return [self getRouteAnnotationView:mapView viewForAnnotation:annotation];
}
这里调用了一个方法,我们用百度SDK中给我们写好的,由于他们写的比较多,还涉及到其他文件,在这里我们举一个例子,所以有的我给注掉了,咱们就看这个现实效果,好看点的效果到时候咱们再去百度SDK中把它拿出来.
- (BMKAnnotationView*)getRouteAnnotationView:(BMKMapView *)mapview viewForAnnotation:(RouteAnnotation*)routeAnnotation{
BMKAnnotationView* view = nil;
switch (routeAnnotation.type) {
case 0:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"start_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"start_node"];
view.image = [UIImage imageNamed:@"icon_nav_start.png"];
view.centerOffset = CGPointMake(0, -(view.frame.size.height * 0.5));
view.canShowCallout = TRUE;
}
view.annotation = routeAnnotation;
}
break;
case 1:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"end_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"end_node"];
view.image = [UIImage imageNamed:@"icon_nav_end.png"];
view.centerOffset = CGPointMake(0, -(view.frame.size.height * 0.5));
view.canShowCallout = TRUE;
}
view.annotation = routeAnnotation;
}
break;
case 2:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"bus_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"bus_node"];
view.image = [UIImage imageNamed:@"icon_nav_bus.png"];
view.canShowCallout = TRUE;
}
view.annotation = routeAnnotation;
}
break;
case 3:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"rail_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"rail_node"];
view.image = [UIImage imageNamed:@"icon_nav_rail.png"];
view.canShowCallout = TRUE;
}
view.annotation = routeAnnotation;
}
break;
case 4:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"route_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"route_node"];
view.canShowCallout = TRUE;
} else {
[view setNeedsDisplay];
}
// UIImage* image = [UIImage imageNamed:@"icon_direction.png"];
// view.image = [image imageRotatedByDegrees:routeAnnotation.degree];
view.annotation = routeAnnotation;
}
break;
case 5:
{
view = [mapview dequeueReusableAnnotationViewWithIdentifier:@"waypoint_node"];
if (view == nil) {
view = [[BMKAnnotationView alloc]initWithAnnotation:routeAnnotation reuseIdentifier:@"waypoint_node"];
view.canShowCallout = TRUE;
} else {
[view setNeedsDisplay];
}
// UIImage* image = [UIImage imageWithContentsOfFile:[self getMyBundlePath1:@"images/icon_nav_waypoint.png"]];
// view.image = [image imageRotatedByDegrees:routeAnnotation.degree];
view.annotation = routeAnnotation;
}
break;
default:
break;
}
return view;
}
效果图如下.
如果你想算出开始到结束的距离(非直线距离,一般我们都是算出走做的里程),可以直接在公交的代理方法中,用BMKTransitRouteLine的distance属性,再除以1000,就可以算出公里数了,
BMKTransitRouteLine* plan = (BMKTransitRouteLine*)[result.routes objectAtIndex:0];
NSLog(@"juli is == %d公里", plan.distance / 1000);
不完整,待续.............