示例中心
功能在线体验
控制台
您现在的位置: 开发 > iOS 地图SDK > 入门指南 >

高德 开发 iOS 地图SDK 入门指南

更新时间:2017年08月01日

第 1 步:获取最新版本的 Xcode

要想使用 高德 AMap SDK for iOS 开发项目,您需要 8.0 版或更高版本的 Xcode。(注:下载地址为Apple官方网站)

第 2 步:获取 CocoaPods

高德 iOS SDK 以 CocoaPods pod 形式提供。 CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。

如果您尚未安装 CocoaPods 工具,请在 OS X 上从终端运行以下命令进行安装。 如需了解详情,请参阅 CocoaPods 入门指南

$ sudo gem install cocoapods

第 3 步:使用 CocoaPods 安装 SDK

为 高德 iOS 地图 SDK 创建一个 Podfile,并使用它来安装 SDK。

1、创建Podfile文件

在您当前工程文件(.xcodeproj)所在文件夹下创建一个名为 Podfile 的文件。如果您尚未创建 Xcode 项目,请立即创建一个并将其保存到您的本地计算机。 (如果您第一次接触 iOS 开发,请创建一个Single View Application。)

$ touch Podfile

2、编辑 Podfile 文件

Podfile文件内容如下:

platform :ios, '7.0' #手机的系统
target 'YourProjectTarget' do
pod 'AMap3DMap'  #3D地图SDK
#pod 'AMap2DMap' #2D地图SDK (2D和3D不能同时使用)
pod 'AMapSearch' #搜索功能
end

注意:使用任何SDK都会自动引入基础 SDK ,涉及到提交AppStore成功与否,请点我查看基础 SDK 的介绍

3、运行 pod install 命令安装SDK

$pod install --repo-update

1.1.0版本的pod,运行pod install 不会自动更新repo,如果下载的不是最新版,可使用pod install —repo-update 更新 或 先运行 pod repo update.

4、更新 SDK

如果您安装的SDK不是最新版,请执行下面的代码进行更新。

pod repo update

5、重启 Xcode

关闭Xcode,然后打开(双击)您项目的 .xcworkspace 文件以启动 Xcode。 从此刻开始,您必须使用 .xcworkspace 文件打开项目。

第 4 步:获取高德Key

请前往高德开放平台控制台申请 iOS Key。

第 5 步:Hello AMap

1.配置Info.plist 文件

iOS9为了增强数据访问安全,将所有的http请求都改为了https,为了能够在iOS9中正常使用地图SDK,请在"Info.plist"中进行如下配置,否则影响SDK的使用。

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true></true>
</dict>

2.配置高德Key至AppDelegate.m文件

将上面步骤获取的高德Key,配置到代码中,以保证地图功能的正常运行。代码如下:

#import <AMapFoundationKit/AMapFoundationKit.h>
//需要引入AMapFoundationKit.h头文件
……

 (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{  
    [AMapServices sharedServices].apiKey = @"您的Key";
     
    ……
}

3.加载地图

在ViewController.m文件相应的方法中进行地图初始化,初始化的步骤:

  1. import MAMapKit.h 头文件;
  2. 构造MAMapView对象;
  3. 将MAMapView添加到Subview中。

对于3D矢量地图,在 viewDidLoad 方法中添加代码:

#import <MAMapKit/MAMapKit.h>

-(void) viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.

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

第 6 步:连接 iOS 设备

了解您的应用实际运行情况的最简单方法是将 iOS 设备与计算机相连。在手机上信任您的开发者证书,并开启定位。

此外,您也可以使用 iOS 模拟器来运行您的应用。 Xcode 中自带了多种模拟器,您可以选择一种模拟器来构建和运行您的应用。

第 7 步:构建和运行您的应用

在 Xcode 中,点击 Product 菜单中 Run 选项(或 Run 按钮图标)运行您的应用。

您可以看到在您的项目里有地图展示。如果您未看到地图,那请检查您是否联网,如果您看到了地图,但是不能使用POI搜索和路径规划等相关功能,请确认是否添加了您的高德Key。

后续步骤

您可能想观摩一些示例代码。您可以在开发者指南中阅读更多有关导航的内容。

示例中心 功能
在线体验
常见问题