高德地图的常见使用

准备工作

高德地图的集成

十分详细的官方集成文档.png

官方文档

使用高德地图

1、引入相应的地图头文件

#import <AMapNaviKit/MAMapKit.h>
#import <AMapFoundationKit/AMapFoundationKit.h>
#import <CoreLocation/CoreLocation.h>

2、声明权限

   <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
   <string>XXX将在XXX等服务中使用您的位置信息!</string>
   <key>NSLocationAlwaysUsageDescription</key>
   <string>XXX将在XXX等服务中使用您的位置信息!</string>
   <key>NSLocationWhenInUseUsageDescription</key>
   <string>XXX将在XXX等服务中使用您的位置信息!</string>
  • Location When In Use Usage Description：“前台定位”
  • Location Always Use Usage Description：“后台定位”
  • Location Always and When In Use Usage Description：“获取定位”

3、用户权限判断

//MARK: - 权限提示
- (void)openLocationAction{
    if (![self openLocationServiceWithBlock]) {
       UIAlertController *alertC = [UIAlertController alertControllerWithTitle:@"打开定位开关" message:@"定位开关未开启，请进入系统【设置】>【隐私】>【定位服务】中打开开关，并允许该APP使用定位服务" preferredStyle:UIAlertControllerStyleAlert];
        UIAlertAction *alertA = [UIAlertAction actionWithTitle:@"我知道了" style:UIAlertActionStyleCancel handler:nil];
        [alertC addAction:alertA];
        [self presentViewController:alertC animated:YES completion:nil];
    }
}
    //MARK: - 权限开启
- (BOOL)openLocationServiceWithBlock {
    BOOL isOpen = NO;
    if ([CLLocationManager locationServicesEnabled] && [CLLocationManager authorizationStatus] != kCLAuthorizationStatusDenied) {
        isOpen = YES;
    }
    return isOpen;
}

4、实例化地图对象

    //初始化地图
    MAMapView *mapView = [[MAMapView alloc] initWithFrame:self.view.bounds];
    //把地图添加至view
    [self.view addSubview:mapView];

常见属性和方法

#pragma mark
#pragma make - 高德地图的属性
///是否显示指南针, 默认YES
- @property (nonatomic, assign) BOOL showsCompass; 

   MAMapTypeStandard = 0,  ///< 普通地图
    MAMapTypeSatellite,     ///< 卫星地图
    MAMapTypeStandardNight, ///< 夜间视图
    MAMapTypeNavi,          ///< 导航视图
    MAMapTypeBus            ///< 公交视图
- @property (nonatomic) MAMapType mapType; 

///缩放级别（默认3-19，有室内地图时为3-20），个人感觉15可以的
- @property (nonatomic) CGFloat zoomLevel;

///是否显示用户位置
- @property (nonatomic) BOOL showsUserLocation;

///是否自定义用户位置精度圈(userLocationAccuracyCircle)对应的 view, 默认为 NO.
///如果为YES: 会调用 - (MAOverlayRenderer *)mapView (MAMapView *)mapView rendererForOverlay:(id <MAOverlay>)overlay 若返回nil, 则不加载.
/// 如果为NO : 会使用默认的样式.
- @property (nonatomic) BOOL customizeUserLocationAccuracyCircleRepresentation;

 ///指定定位是否会被系统自动暂停
@property (nonatomic) BOOL pausesLocationUpdatesAutomatically;

///是否允许后台定位。默认为NO。只在iOS 9.0之后起作用。
///设置为YES的时候必须保证 Background Modes 中的 Location updates处于选中状态，否则会抛出异常。
///注意：定位必须在停止的状态下设置（showsUserLocation = NO），否则无效
@property (nonatomic) BOOL allowsBackgroundLocationUpdates;

///设置当前地图的中心点，改变该值时，地图的比例尺级别不会发生变化
@property (nonatomic) CLLocationCoordinate2D centerCoordinate;

#pragma mark
#pragma make - 高德地图的方法
/**
 * @brief 移除标注
 * @param annotation 要移除的标注
 */
- (void)removeAnnotation:(id <MAAnnotation>)annotation;

/**
 * @brief 移除一组标注
 * @param annotations 要移除的标注数组
 */
- (void)removeAnnotations:(NSArray *)annotations;

/**
 * @brief 向地图窗口添加标注，需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View
 * @param annotation 要添加的标注
 */
- (void)addAnnotation:(id <MAAnnotation>)annotation;

/**
 * @brief 向地图窗口添加一组标注，需要实现MAMapViewDelegate的-mapView:viewForAnnotation:函数来生成标注对应的View
 * @param annotations 要添加的标注数组
 */
- (void)addAnnotations:(NSArray *)annotations;

/**
 * @brief 选中标注数据对应的view。注意：如果annotation对应的annotationView因不在屏幕范围内而被移入复用池，为了完成选中操作，会将对应的annotationView添加到地图上，并将地图中心点移至annotation.coordinate的位置。
 * @param annotation 标注数据
 * @param animated 是否有动画效果
 */
// 注：选中之可以手动添加气泡的显示
- (void)selectAnnotation:(id <MAAnnotation>)annotation animated:(BOOL)animated;

#pragma mark
#pragma make - 高德地图MAMapViewDelegate代理方法
/**
* @brief 位置或者设备方向更新后，会调用此函数
* @param mapView 地图View
* @param userLocation 用户定位信息(包括位置与设备方向等数据)
* @param updatingLocation 标示是否是location数据更新, YES:location数据更新 NO:heading数据更新
*/
- (void)mapView:(MAMapView *)mapView didUpdateUserLocation:(MAUserLocation *)userLocation updatingLocation:(BOOL)updatingLocation{
//    if (updatingLocation) {
//        self.Mylat = userLocation.coordinate.latitude;
//        self.Mylng = userLocation.coordinate.longitude;
//        
//        if (!self.isFirstIn) {
//            [self.mapView setCenterCoordinate:CLLocationCoordinate2DMake(self.Mylat, self.Mylng)];
//            self.isFirstIn = YES;
//        }
//    } 
}

/**
 *  @brief 当plist配置NSLocationAlwaysUsageDescription或者NSLocationAlwaysAndWhenInUseUsageDescription，并且[CLLocationManager authorizationStatus] == kCLAuthorizationStatusNotDetermined，会调用代理的此方法。
    此方法实现调用后台权限API即可（ 该回调必须实现 [locationManager requestAlwaysAuthorization] ）; since 6.8.0
 *  @param locationManager  地图的CLLocationManager。
 */
- (void)mapViewRequireLocationAuth:(CLLocationManager *)locationManager{
    [locationManager requestAlwaysAuthorization];
}

/**
 * @brief 当选中一个annotation view时，调用此接口. 注意如果已经是选中状态，再次点击不会触发此回调。取消选中需调用-(void)deselectAnnotation:animated:
 * @param mapView 地图View
 * @param view 选中的annotation view
 */
- (void)mapView:(MAMapView *)mapView didSelectAnnotationView:(MAAnnotationView *)view{
   //    NSLog(@"%@",view);
  //    [((WMCustomAnnotationView *)view) setUpClloutView];
}

/**
 * @brief 当取消选中一个annotation view时，调用此接口
 * @param mapView 地图View
 * @param view 取消选中的annotation view
 */
- (void)mapView:(MAMapView *)mapView didDeselectAnnotationView:(MAAnnotationView *)view{
//    NSLog(@"%@",view);
//    [((WMCustomAnnotationView *)view) removeAnnotationView];
}

自定义大头针和气泡

大头针(imageView)是显示在地图上是一个图片，是高德地图MAAnnotationView的imageView，设置imageView就是设置地图上的大头针了。气泡（CalloutView）一般是显示在大头针（MAPointAnnotation）顶部的一个视图，归根结底是一个view。它是添加在大头针视图（MAAnnotationView）上的一个视图。
1、新建类
1.1、新建Annotation类，继承于MAPointAnnotation

#import <AMapNaviKit/AMapNaviKit.h>
#import "WMDeviceLocationModel.h"
@interface WMCustomLocalAnnotation :MAPointAnnotation
/* 需要传给MAAnnotationView视图的数据 */
@property (nonatomic, strong) WMDeviceLocationDataModel *dataModel;
@end

1.2、新建AnnotationView类，继承于MAAnnotationView

#import <AMapNaviKit/MAMapKit.h>
#import "WMCustomLocalView.h"
#import "WMDeviceLocationModel.h"
@interface WMCustomAnnotationView : MAAnnotationView
/* AnnotationView对应的数据模型 */
@property (nonatomic, strong) WMDeviceLocationDataModel * _Nullable dataModel;
@end

//复写父类init方法
- (id)initWithAnnotation:(id<MAAnnotation>)annotation reuseIdentifier:(NSString *)reuseIdentifier
{
    if (self = [super initWithAnnotation:annotation reuseIdentifier:reuseIdentifier]){
       //给大头针视图布局
        [self setupUI]
    }
    return self;
}
- (void)setupUI{

}

2、创建Annotation对象，并传值

// 创建Annotation< WMCustomLocalAnnotation >
WMCustomLocalAnnotation *annotation = [[WMCustomLocalAnnotation alloc] init]; 
// 为Annotation的dataModel赋值，local为需要展示的数据
annotation.dataModel = local;
// 将annotation对象添加到地图中，调用addAnnotation方法时，会走
// - (MAAnnotationView *)mapView:(MAMapView *)mapView viewForAnnotation:(id<MAAnnotation>)annotation的代理方法
[self.mapView addAnnotation:annotation];
// 设置地图中心点
[self.mapView setCenterCoordinate: annotation.coordinate];

// 看业务要求，是否需要在添加Annotation前，删除其余Annotation
for (id anno in self.mapView.annotations) {
       if ([anno isKindOfClass:[WMCustomLocalAnnotation class]]) {
          [self.mapView removeAnnotation:anno];
      }
 }

3、创建WMCustomAnnotationView对象，并赋值

/**
* @brief 根据anntation生成对应的View
* @param mapView 地图View
* @param annotation 指定的标注
* @return 生成的标注View
*/
- (MAAnnotationView *)mapView:(MAMapView *)mapView viewForAnnotation:(id<MAAnnotation>)annotation{
    // 创建WMCustomAnnotationView
    if ([annotation isKindOfClass:[WMCustomLocalAnnotation class]]) {
        WMCustomAnnotationView  *newAnnotationView = (WMCustomAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:@"userInfoAnnotation"];
        if (!newAnnotationView) {
            newAnnotationView = [[WMCustomAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:@"userInfoAnnotation"];
            // canShowCallout：是否允许弹出callout
            newAnnotationView.canShowCallout = NO;
            ///是否支持拖动
            newAnnotationView.draggable = YES;
        }
        //给气泡赋值
        WMCustomLocalAnnotation *customAnnotation = (WMCustomLocalAnnotation *)annotation;
        newAnnotationView.dataModel = customAnnotation.dataModel;
        return newAnnotationView;
    }
    return nil;
}
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,544评论 6赞 501
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,430评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 162,764评论 0赞 353
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,193评论 1赞 292
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,216评论 6赞 388
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,182评论 1赞 299
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,063评论 3赞 418
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,917评论 0赞 274
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,329评论 1赞 310
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2赞 332
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,425评论 5赞 343
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,019评论 3赞 326
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1赞 269
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2赞 368
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2赞 353