最近在做基于高德地图的定位、导航及添加大头针的功能,特此记录下来。。。方便刚接触的同学参考。。。
一、申请 Key:获取用户Key
1.访问 http://lbs.amap.com/console/key/,使用高德开发者账号登陆
2.在“KEY管理”页面点击上方的“获取key”按钮,依次输入应用名,选择绑定的服务为“iOS平台SDK”,输入 Bundle Identifier(获取方法请参考:获取 Bundle Indentifier),如下图所示:
获取 Bundle ID:iOS bundle 获取方式
方法一:
通过代码获取,代码如下所示:NSString *bundleIdentifier = [[NSBundle mainBundle] bundleIdentifier];
方法二:
Xcode 切换到 General 标签,查看 Bundle Identifier,如下图所示:
二、在地图显示前进行项目的配置工作:
在plist配置字段
定位权限
NSLocationAlwaysUsageDescription:一直定位
NSLocationWhenInUseUsageDescription:需要时定位
ATS设置:Https协议
三、前往高德地图官网下载需要使用的SDK,解压得到如图framework:
地图显示是地图 SDK 的基础功能,是使用地图定位、导航等他功能的载体。
首先,在lbs.amap.com/api/ios-sdk/download/页面中根据您的需求下载库文件并解压,包括:
3D 矢量地图库,解压后得到 MAMapKit.framework 文件。3D 矢量地图效果优,可查看 3D 楼块,功能全,还支持离线地图,能帮您节省流量。目前暂不支持地图多实例。
2D 栅格地图库,解压后得到 MAMapKit.framework 文件。2D 栅格地图库体积小,能耗低。支持地图多实例。
搜索库,解压后得到 AMapSearchKit.framework 文件。搜索库功能包含:POI 查询、路径规划、地理编码和逆地理编码、公交查询以及输入提示语查询
注意:3D矢量地图和2D栅格地图只能选择一个使用,接口类似,但是地图显示样式不同。
1、新建工程:新建一个 GDMap_DEMO Application工程,如下图所示:、
2、配置工程:引入地图库
左侧目录中选中工程名,在 TARGETS->Build Phases-> Link Binary With Libaries 中点击 “+” 按钮,在弹出的窗口中点击 “Add Other” 按钮,选择解压后的 MAMapKit.framework 文件添加到工程中。
3、引入AMap.bundle资源文件,AMap.bundle 资源文件中存储了定位、默认大头针标注视图等图片,可利用这些资源图片进行开发,
左侧目录中选中工程名,在右键菜单中选择 Add Files to “工程名”…,从MAMapKit.framework->Resources 文件中选择 AMap.bundle 文件,并勾选 “Copy items if needed” 复选框,单击 “Add” 按钮,将资源文件添加到工程中。
4、引入高德地图依赖系统库文件:
说明:
1.备注中,2D表示使用2D栅格地图需要的系统文件,3D表示使用3D矢量地图需要的系统文件、Search表示使用搜索库需要的系统文件,3D(V3.X.X)表示3D矢量地图V3.0.0以后版本需要新增的库。
2.SystemConfiguration.framework、CoreTelephonySecurity.framework、Security.framework 是为了统计app信息使用。
3.iOS9后,需要把libz.dylib、libstdc++6.09.dylib、libc++.dylib替换成libz.tbd、libstdc++6.09.tbd、libc++.tbd。
引入系统库的操作如下:
左侧目录中选中工程名,在TARGETS->Build Settings-> Link Binary With Libaries中点击“+”按钮,在弹出的窗口中查找并选择所需的库(见下表),单击“Add”按钮,将库文件添加到工程中。
四、地图显示
1、配置用户Key:在使用地图 SDK 时,需要对应用做 Key 机制验证,在地图初始化之前添加如下示例代码,配置之前在官网上申请的 Key:如果地图显示不出来,请检查key设置的是否正确
```
在 appDelegate.m的方法 :
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.、
中设置key:
[AMapServices sharedServices].apiKey = @“申请的key”;//最新的SDK使用AMapServices或
[MAMapServices sharedServices].apiKey = @"用户Key";//比较老的SDK使用
return YES;
}
```
2、
1)在想要显示地图的 ViewController.m 文件中,引入 MAMapKit.h 文件,继承 MAMapViewDelegate 协议,并定义 MAMapView 对象,示例代码如下所示:
```
#import#import@interface ViewController ()//地图
@property (nonatomic, strong) MAMapView *mapView;
@end
```
2)在 ViewController.m 文件相应的方法中进行地图初始化,初始化的步骤:
(1).构造 MAMapView 对象;(2).设置代理;(3).将 MAMapView 添加到 Subview 中
//地图初始化
```
self.mapView = [[MAMapView alloc] initWithFrame:CGRectMake(0, 64, KScreenWidth, KScreenHeight)];
_mapView.backgroundColor = [UIColor whiteColor];
self.mapView.delegate = self;
//设置定位精度
// _mapView.desiredAccuracy = kCLLocationAccuracyBest;
//设置定位距离
// _mapView.distanceFilter = 5.0f;
_mapView.zoomEnabled = YES;
//普通样式
_mapView.mapType = MAMapTypeStandard;
//地图跟着位置移动
[_mapView setUserTrackingMode:MAUserTrackingModeFollow animated:YES];
//设置成NO表示关闭指南针;YES表示显示指南针
_mapView.showsCompass= NO;
//设置指南针位置
_mapView.compassOrigin= CGPointMake(_mapView.compassOrigin.x, 22);
//设置成NO表示不显示比例尺;YES表示显示比例尺
_mapView.showsScale= NO;
//设置比例尺位置
_mapView.scaleOrigin= CGPointMake(_mapView.scaleOrigin.x, 22);
//缩放等级
[_mapView setZoomLevel:16 animated:YES];
//开启定位
_mapView.showsUserLocation = YES;
[self.view addSubview:self.mapView];
```
当位置更新时,会进定位回调,通过回调函数,能获取到定位点的经纬度坐标,示例代码如下:
```
- (void)mapView:(MAMapView *)mapView didUpdateUserLocation:(MAUserLocation *)userLocation updatingLocation:(BOOL)updatingLocation {
//userLocation 就是用户当前的位置信息,通过userLocation 可以获取当前的经纬度信息及详细的地理位置信息,方法如下:
//创建一个经纬度点:
MAPointAnnotation *point = [[MAPointAnnotation alloc] init];
//设置点的经纬度
point.coordinate = _currentUL.location.coordinate;
CLLocation *currentLocation = [[CLLocation alloc]initWithLatitude:_currentUL.location.coordinate.latitude longitude:_currentUL.location.coordinate.longitude];
// 初始化编码器
CLGeocoder *geoCoder = [[CLGeocoder alloc] init];
[geoCoder reverseGeocodeLocation:currentLocation completionHandler:^(NSArray *placemarks, NSError *error) {
//获取当前城市位置信息,其中CLPlacemark包括name、thoroughfare、subThoroughfare、locality、subLocality等详细信息
CLPlacemark *mark = [placemarks lastObject];
NSString *cityName = mark.locality;
// NSLog(@"城市 - %@", cityName);
self.currentCity = cityName;
}];
}
```
查看显示效果:
四、添加大头针:
代码:
//创建坐标
```
CLLocationCoordinate2D coor ;
coor.latitude = @“39.33232132323”;
coor.longitude = @“116.23423423423”;
MAPointAnnotation *pointAnnotation = [[MAPointAnnotation alloc] init];
pointAnnotation.coordinate = coor;
//设置地图的定位中心点坐标
self.mapView.centerCoordinate = coor;
//将点添加到地图上,即所谓的大头针
[self.mapView addAnnotation:pointAnnotation];
添加了大头针,会进入mapview的代理方法:在代理方法中可以设置大头针的显示图片,及点击大头针弹出的气泡视图
- (MAAnnotationView *)mapView:(MAMapView *)mapView viewForAnnotation:(id)annotation {
//大头针标注
if ([annotation isKindOfClass:[MAPointAnnotation class]]) {//判断是否是自己的定位气泡,如果是自己的定位气泡,不做任何设置,显示为蓝点,如果不是自己的定位气泡,比如大头针就会进入
static NSString *pointReuseIndentifier = @"pointReuseIndentifier";
MAAnnotationView*annotationView = (MAAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:pointReuseIndentifier];
if (annotationView == nil) {
annotationView = [[MAAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:pointReuseIndentifier];
}
annotationView.frame = CGRectMake(0, 0, 100, 100);
annotationView.canShowCallout= YES; //设置气泡可以弹出,默认为NO
//annotationView.animatesDrop = YES; //设置标注动画显示,默认为NO
annotationView.draggable = YES; //设置标注可以拖动,默认为NO
// annotationView.pinColor = MAPinAnnotationColorPurple;
//设置大头针显示的图片
annotationView.image = [UIImage imageNamed:@"point"];
//点击大头针显示的左边的视图
UIImageView *imageV = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"backImage"]];
annotationView.leftCalloutAccessoryView = imageV;
//点击大头针显示的右边视图
UIButton *rightButton = [[UIButton alloc] initWithFrame:CGRectMake(0, 0, 80, 50)];
rightButton.backgroundColor = [UIColor grayColor];
[rightButton setTitle:@"导航" forState:UIControlStateNormal];
annotationView.rightCalloutAccessoryView = rightButton;
// annotationView.image = [UIImage imageNamed:@"redPin"];
return annotationView;
}
return nil;
}
```
查看效果图:
五、后续更新导航功能,请继续关注。。。