导航|地址|刷新
概述-iOS 地图SDK | 高德地图API













控制台

去认证企业


登录注册









退出


我的消息

云图市场

应用管理

GeoHUB




产品介绍

产品介绍高德开放平台产品介绍 查看全部文档

搜索定位


鸿蒙星河版定位SDK HOT鸿蒙星河版定位SDK

搜索 HOT位置、周边、行政区、ID等查询接口 API JS Android iOS

定位 HOT基于LBS的定位服务 API Android iOS

地理/逆地理编码 位置名称与经纬度之间转换服务 API JS Android iOS

地理围栏 虚拟空间围栏服务 API Android iOS

天气查询 查询目标区域当前/未来天气

智能硬件定位 通过基站、Wifi获取位置信息




路线导航


鸿蒙星河版导航SDK NEW鸿蒙星河版导航SDK

导航 HOT轻松地在APP中加入导航能力 Android iOS

路线规划 HOT提供步行、驾车等规划能力 API JS Android iOS

猎鹰服务 提供专业轨迹管理服务 API Android iOS

货车路径规划 专业的货车路径规划服务 API Android iOS

智能调度引擎 智能外勤调度，提升效益

物流服务 提供智慧物流API服务接口

公交信息查询 查询公交信息

交通路况查询 查询交通态势情况

高级路径规划 高级路径规划等能力




地图产品


鸿蒙星河版地图SDK HOT鸿蒙星河版-轻量地图SDK

动态地图 HOT动态地图展示、配置 API JS Android iOS HarmonyOS

3D地图 HOT3D动态地图展示、配置

地铁图 简单易用的移动端地铁线路图开发接口 JS Android iOS

静态地图 灵活地将高德地图迁入应用网页

3D地形图 卫星地形图还原真实地形地貌




高级地图工具


世界地图 NEW

自定义地图

地图数据可视化 (LOCA)

地图数据中心 (GeoHUB)

坐标拾取器

高德地图URI Web

高德地图URI APP

三维模型转换

微信小程序插件

地图Flutter插件

地图名片




高德地图小程序


地图小程序

客户管理

员工管理

送货提效

地图小程序API




空间智能开放平台


空间智能开放平台 NEW用真实空间信息解答业务问题






解决方案

解决方案提供各行业LBS解决方案


空间智能 NEW提供LBS领域的Agent解决方案

智能手表 NEW提供智能守护与运动出行解决方案

智能眼镜 NEW智能眼镜实时导航及智慧出行解决方案

世界地图 NEW面向开发者提供全球范围内LBS服务

智能两轮车 NEW合规精确的两轮车场景导航

手机银行 NEW提供手机银行APP地图应用





网格化营销 NEW提供银行网格化营销场景应用

智慧交通 优化交通资源配置，赋能智慧交通系统

出行 提供网约车等出行场景解决方案

O2O 到店、到家等多种O2O业务解决方案

上门服务调度 提供上门业务调度解决方案





三农场景可视化 NEW提供乡村振兴三农场景应用

社交 社交应用位置服务解决方案

运动 运动类应用解决方案

智能硬件 智能硬件LBS解决方案

零售铺货 零售快消行业，渠道铺货解决方案





智慧物流 针对物流行业提供解决方案

电商 电商物流行业解决方案

地址服务 综合地址服务，满足客户全景化需求

企业智图 一张图轻松管理企业数据

智能派单 一站式精准智能派单解决方案






文档与支持

文档与支持高德开放平台开发文档与服务支持 查看全部文档

API


Web基础服务API

Web高级服务API

物流服务API

猎鹰服务 API




JS API


JS API

数据可视化JS API

地图组件

URI API

地铁图 JS API




Android 平台


Android 地图SDK

Android 轻量版地图SDK

Android 定位SDK

Android 导航SDK

Android 猎鹰SDK




iOS 平台


iOS 地图SDK

iOS 轻量版地图SDK

iOS 定位SDK

iOS 导航SDK

iOS 猎鹰SDK




鸿蒙星河版平台


鸿蒙星河版地图SDK HOT

鸿蒙星河版定位SDK HOT

鸿蒙星河版导航SDK NEW




大模型开发工具


SKILL专区 NEW

MCP Server NEW

高德开放平台 CLI NEW




服务与支持


常见问题

创建工单

示例中心

合规中心

技术服务许可查询






定价

定价开放平台产品定价 产品定价

产品定价


产品定价

技术服务许可

GeoHUB自定义地图

GeoHUB数据中心




产品升级


高级能力

企业智图SaaS

云图市场






为什么选择高德




















历史记录

热门推荐
Android定位Android定位问题相关

浏览器定位JS API提供Geolocation定位插件

逆地理编码经纬度转换为详细结构化的地址

自定义地图7大类44种地图元素可定制

认证开发商商业授权相关问题














iOS 地图SDK


概述

入门指南

开发指南
创建工程
获取Key

自动部署

手动部署

开发者注意事项

基础SDK介绍

提交AppStore必读

应用HTTPS解决方案


创建地图
显示地图

显示定位蓝点

显示3D地形图

显示室内地图

切换地图图层

使用离线地图

自定义地图

世界地图


与地图交互
控件交互

手势交互

调用方法交互

地图截屏功能


获取地图数据
获取POI数据

获取地址描述数据

获取公交数据

获取行政区划数据

获取天气数据

获取交通态势信息


在地图上绘制
绘制点标记

绘制折线

绘制面

轨迹纠偏

点平滑移动

绘制海量点图层


出行线路规划
驾车出行路线规划

步行出行路线规划

公交出行路线规划

骑行出行路线规划

货车出行路线规划

未来行程路线规划




地图计算工具
坐标转换

距离/面积计算

距离测量


实用工具
错误码表

天气对照表

基于 Swift 的地图应用开发

体积说明



参考手册
3D 地图 SDK

2D 地图 SDK

搜索功能

Foundation(基础) SDK


示例代码

示例中心

常见问题

更新日志
3D 地图 SDK

搜索功能

Foundation(基础) SDK


相关下载






开发iOS 地图SDK概述


概述最后更新时间: 2025年12月03日


重要：由于个人信息保护法的实施，从地图8.1.0版本起对旧版本SDK不兼容，请务必确保调用SDK任何接口前先调用更新隐私合规updatePrivacyShow、updatePrivacyAgree两个接口，否则可能导致功能不可用等异常情况。具体可参考开发指南-其他配置注意事项-隐私合规接口说明传入相关参数。

高德地图iOS SDK简介

高德开放平台目前开放了 iOS 地图 SDK 以及 iOS 地图 SDK 专业版两套地图SDK工具。

高德地图 iOS SDK 是一套基于 iOS 8.0 及以上版本的地图应用程序开发接口，供开发者在自己的iOS应用中加入地图相关的功能，包括：地图显示（含室内、室外地图）、与地图交互、在地图上绘制、兴趣点搜索、地理编码、离线地图等功能。

高德地图 iOS SDK 专业版是在 iOS SDK 已有服务的基础上，新增支持了自定义地图在线加载、自定义地图元素纹理等功能，便于开发者完成基于自身场景的更深层、更个性化地图的开发需求。




抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签




展示地图
/*创建地图并添加到父view上*/ self.mapView = [[MAMapView alloc] initWithFrame:self.view.bounds]; self.mapView.delegate = self; [self.view addSubview:self.mapView];


Marker
/*添加annotation*/ self.annotations = [NSMutableArray array]; CLLocationCoordinate2D coordinates[10] = { {39.992520, 116.336170}, {39.992520, 116.336170}, {39.998293, 116.352343}, {40.004087, 116.348904}, {40.001442, 116.353915}, {39.989105, 116.353915}, {39.989098, 116.360200}, {39.998439, 116.360201}, {39.979590, 116.324219}, {39.978234, 116.352792}}; for (int i = 0; i < 10; ++i) { MAPointAnnotation *a1 = [[MAPointAnnotation alloc] init]; a1.coordinate = coordinates[i]; a1.title = [NSString stringWithFormat:@"anno: %d", i]; [self.annotations addObject:a1]; } - (void)viewDidAppear:(BOOL)animated { [super viewDidAppear:animated]; [self.mapView addAnnotations:self.annotations]; [self.mapView showAnnotations:self.annotations edgePadding:UIEdgeInsetsMake(20, 20, 20, 80) animated:YES]; } /* 实现代理方法：*/ - (MAAnnotationView *)mapView:(MAMapView *)mapView viewForAnnotation:(id<MAAnnotation>)annotation { if ([annotation isKindOfClass:[MAPointAnnotation class]]) { static NSString *pointReuseIndetifier = @"pointReuseIndetifier"; MAPinAnnotationView *annotationView = (MAPinAnnotationView*)[mapView dequeueReusableAnnotationViewWithIdentifier:pointReuseIndetifier]; if (annotationView == nil) { annotationView = [[MAPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:pointReuseIndetifier]; } annotationView.canShowCallout = YES; annotationView.animatesDrop = YES; annotationView.draggable = YES; annotationView.rightCalloutAccessoryView = [UIButton buttonWithType:UIButtonTypeDetailDisclosure]; annotationView.pinColor = [self.annotations indexOfObject:annotation] % 3; return annotationView; } return nil; }


驾车路线规划
AMapDrivingRouteSearchRequest *navi = [[AMapDrivingRouteSearchRequest alloc] init]; navi.requireExtension = YES; navi.strategy = 5; /* 出发点. */ navi.origin=[AMapGeoPoint locationWithLatitude:self.startCoordinate.latitude longitude:self.startCoordinate.longitude]; /* 目的地. */ navi.destination = [AMapGeoPoint locationWithLatitude:self.destinationCoordinate.latitude longitude:self.destinationCoordinate.longitude]; [self.search AMapDrivingRouteSearch:navi];


搜索POI
/* 根据ID来搜索POI. */ - (void)searchPoiByID { AMapPOIIDSearchRequest *request = [[AMapPOIIDSearchRequest alloc] init]; request.uid = @"B000A7ZQYC"; request.requireExtension = YES; [self.search AMapPOIIDSearch:request]; } /* 根据关键字来搜索POI. */ - (void)searchPoiByKeyword { AMapPOIKeywordsSearchRequest *request = [[AMapPOIKeywordsSearchRequest alloc] init]; request.keywords = @"北京大学"; request.city = @"北京"; request.types = @"高等院校"; request.requireExtension = YES; /* 搜索服务 3.2.0 中新增加的功能，只搜索本城市的POI。*/ request.cityLimit = YES; request.requireSubPOIs = YES; [self.search AMapPOIKeywordsSearch:request]; }


自定义OpenGL渲染
/* 计算经纬度坐标对应的OpenGL坐标，每次地图坐标系有变化均会调用这个方法。 */ - (void)referenceDidChange { [super referenceDidChange]; //根据z=0平面的尺寸计算新的参考坐标系距离单位 CGPoint * bottomGlPts = [self glPointsForMapPoints:_bottomMapPts count:2]; _cubePointCount = totalVertexCount; CGFloat sideLenOnGL = [self lengthBetweenPointA:bottomGlPts[0] andPointB:bottomGlPts[1]]; float w = sideLenOnGL * 0.5f; _move = Vertex(w,0,0); /*计算模型中心的GL坐标。*/ MAMapPoint center = MAMapPointForCoordinate(self.overlay.coordinate); CGPoint centerGL = [self glPointForMapPoint:center]; _cubeCenterGL = Vertex(centerGL.x, centerGL.y, w); /* 创建vertex。 */ _cubePoints[0] = Vertex(-w, -w, -w); _cubePoints[1] = Vertex(-w, -w, w); _cubePoints[2] = Vertex(w, -w, -w); _cubePoints[3] = Vertex(w, -w, w); _cubePoints[4] = Vertex(w, w, -w); _cubePoints[5] = Vertex(w, w, w); _cubePoints[6] = Vertex(-w, w, -w); _cubePoints[7] = Vertex(-w, w, w); free(bottomGlPts); /* 创建index。 */ const GLuint indexCountOnSideFace = 24; //4个侧面 for (int i = 0, j = 0; i < _cubePointCount && j < indexCountOnSideFace; i = i + 2) { _cubeIndices[j++] = i; _cubeIndices[j++] = i+1; _cubeIndices[j++] = (i+2)%_cubePointCount; _cubeIndices[j++] = i+1; _cubeIndices[j++] = (i+3)%_cubePointCount; _cubeIndices[j++] = (i+2)%_cubePointCount; } //顶面和底面 for (int i = 0, j = indexCountOnSideFace; i < 2 && j < indexCount; i++) { _cubeIndices[j++] = i; _cubeIndices[j++] = i + 2; _cubeIndices[j++] = i + 4; _cubeIndices[j++] = i; _cubeIndices[j++] = i + 4; _cubeIndices[j++] = i + 6; } } /* OpenGL绘制。 */ - (void)glRender { glEnable(GL_DEPTH_TEST); glDepthFunc(GL_ALWAYS); glEnable(GL_BLEND); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); glDisable(GL_TEXTURE_2D); glEnableClientState(GL_VERTEX_ARRAY); //进行位移 glPushMatrix(); const float speed = 0.1; static float i = 0; glTranslatef(_cubeCenterGL.x + _move.x * i, _cubeCenterGL.y + _move.y * i, _cubeCenterGL.z + _move.z * i); float forward = speed; if (i > 6) { forward = -speed; }else if(i < -6) { forward = speed; } i = i + forward; glVertexPointer(3, GL_FLOAT, 0, _cubePoints); const GLuint faceCount = 6; const GLuint indexCountPerFace = 6; GLfloat r,b,g; for(int i = 0; i < faceCount; i++) { r = 0.5 + 0.5 * (i&1); g = 0.5 + 0.5 * (i&2); b = 0.5 + 0.5 * (i&4); glColor4f(r, g, b, 0.5); glDrawElements(GL_TRIANGLES, indexCountPerFace, GL_UNSIGNED_SHORT, &_cubeIndices[i*indexCountPerFace]); } glPopMatrix(); //结束位移 glDisableClientState(GL_VERTEX_ARRAY); glDisable(GL_BLEND); glDisable(GL_DEPTH_TEST); }


离线地图
[[MAOfflineMap sharedOfflineMap] downloadItem:item shouldContinueWhenAppEntersBackground:YES downloadBlock:^(MAOfflineItem * downloadItem, MAOfflineMapDownloadStatus downloadStatus, id info) { if (![self.downloadingItems containsObject:downloadItem]) { [self.downloadingItems addObject:downloadItem]; [self.downloadStages setObject:[NSMutableDictionary dictionary] forKey:downloadItem.adcode]; } /* Manipulations to your application’s user interface must occur on the main thread. */ dispatch_async(dispatch_get_main_queue(), ^{ NSMutableDictionary *stage = [self.downloadStages objectForKey:downloadItem.adcode]; if (downloadStatus == MAOfflineMapDownloadStatusWaiting) { [stage setObject:[NSNumber numberWithBool:YES] forKey:DownloadStageIsRunningKey2]; } else if(downloadStatus == MAOfflineMapDownloadStatusProgress) { [stage setObject:info forKey:DownloadStageInfoKey2]; } else if(downloadStatus == MAOfflineMapDownloadStatusCancelled || downloadStatus == MAOfflineMapDownloadStatusError || downloadStatus == MAOfflineMapDownloadStatusFinished) { [stage setObject:[NSNumber numberWithBool:NO] forKey:DownloadStageIsRunningKey2]; // clear [self.downloadingItems removeObject:downloadItem]; [self.downloadStages removeObjectForKey:downloadItem.adcode]; } [stage setObject:[NSNumber numberWithInt:downloadStatus] forKey:DownloadStageStatusKey2]; /* Update UI. */ //更新触发下载操作的item涉及到的UI [self updateUIForItem:item atIndexPath:indexPath]; if (downloadStatus == MAOfflineMapDownloadStatusFinished) { self.needReloadWhenDisappear = YES; } }); }];




下载完整示例代码



账号与Key的申请

注册成为高德开发者需要分三步：

第一步，注册高德开发者；

第二步，去控制台创建应用；

第三步，获取Key。

具体步骤可参看下图



获取 API Key



兼容性 

高德地图iOS 地图 SDK 4.4.0以下版本支持iOS 6.0及以上系统；

高德地图iOS 地图 SDK 4.4.0及以上版本支持 iOS 7.0及以上系统；

高德地图iOS 地图 SDK 6.7.0及以上版本支持 iOS 8.0及以上系统。

开发者使用注意事项

（1）法人或非法人组织使用平台服务应事先购买技术服务许可以获取许可。若您未购买技术服务许可，平台向您提供的KEY和服务配额仅供您用于短期、少量的测试目的；若您超出前述范围使用平台服务（包括但不限于您开始向第三方或公众销售或提供您的应用、将您的应用用于参与第三方投标、您的应用在应用程序分发平台上架或已经可以被公众获取使用、您的应用开始收费或发布广告或以其他方式获益、在组织内部使用的您的应用已上线运营、您的应用长期或大量调用平台服务等情形），构成未许可使用，平台有权采取相应措施。关于具体使用规则，请参阅《高德地图开放平台服务协议》获得详细信息。 

（2）iOS V2.0.6.1（含）之前版本的SDK搜索服务将于2015年2月底停止使用，涉及到POI查询、地理编码、逆地理编码、路径规划、公交查询。如您已采用旧版iOS SDK进行开发，建议您采用最新版本的 iOS SDK进行开发，请参阅升级方案。

（3）iOS SDK V2.4.0（含）之后版本适配了arm 64架构，免除您的app提交到app store的后顾之忧。













本页目录

高德地图iOS SDK简介

兼容性 

开发者使用注意事项








新手入门产品与服务解决方案开发文档

商务合作商务合作商家合作

常见问题账号问题定位反馈常见问题汇总服务协议隐私权政策免责声明数据退出

开放平台关注我们微信微博


阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 飞猪 | 阿里云计算 | AliOS | 阿里通信 | 一淘 | 万网 | 高德 | UC | 友盟 | 虾米 | 阿里星球 | 点点虫 | 钉钉 | 支付宝 | 优酷 | 土豆 | 阿里健康 | 阿里影业 | 阿里体育 | 网商银行 | 高德打车企业版 | 高德地图汽车业务中心 | 高德智慧景区
© 2002-2026 Amap.com 版权所有 | 京ICP备2023020281号-12 | 甲测资字11112528 | 甲测资字11111093

京公网安备 11010502056787号



返回顶部示例中心常见问题智能客服公众号
二维码


------
导航页 打开网址