關於高德地圖

1目的

為了更方便的使用，以及避免犯錯

2 整合步驟

2.1 申請金鑰

2.2 配置環境（重點）

高德地圖提供了兩種配置方式：

一、 手動配置

即手動匯入所需要的庫檔案，以及進行相關的配置操作。手動配置相對麻煩，作簡要說明，詳見官方文件。

1. 引入地相簿

MAMapKit.framework 檔案新增到工程中。

2. 引入AMap.bundle資原始檔

AMap.bundle資原始檔中儲存了定位、預設大頭針標註檢視等圖片，可利用這些資源圖片進行開發。
左側目錄中選中工程名，在右鍵選單中選擇Add Files to “工程名”…，從MAMapKit.framework->Resources檔案中選擇AMap.bundle檔案，並勾選“Copy items if needed”複選框，單擊“Add”按鈕，將資原始檔新增到工程中。
資原始檔不是必須的，可以自定義資源圖片。

3. 引入系統庫

1.  UIKit.framework 2D、3D、Search
2.  Foundation.framework    2D、3D、Search
3.  CoreGraphics.framework  2D、3D、Search
4.  QuartzCore.framework    2D、3D
5.  OpenGLES.framework  3D
6.  CoreLocation.framework  2D、3D
7.  CoreTelephony.framework 2D、3D、Search
8.  SystemConfiguration.framework   2D、3D、Search
9.  libz.dylib  2D、3D、Search
10. libstdc++6.09.dylib 2D、3D、Search
11. Security.framework  2D、3D
 

4. 環境配置

在TARGETS->Build Settings->Other Linker Flags 中新增-ObjC。
V2.3.0（含）之前版本不支援arm64，需在 TARGETS->Build Settings->Architectures 點出選擇框，選擇 “Other”，將預設值修改為 $(ARCHS_STANDARD_32_BIT)。

二、 自動配置，即使用cocoaPods去新增庫。

CocoaPods相對簡單，自動管理第三方庫。不需要額外的其他配置即可使用。配置詳見官方文件。
編輯Podfile內容如下：
platform :ios, ‘7.0’ #手機的系統
pod ‘AMap3DMap’ #3D地圖SDK
#pod ‘AMap2DMap’ #2D地圖SDK (2D和3D不能同時使⽤用)
pod ‘AMapSearch’ #搜尋服務SDK
在PodFile所在的資料夾下輸入命令：
pod install

3 地圖的使用

3.1 基礎地圖

3.1.1 地圖Logo

預設的Logo為藍色字樣的“高德地圖”，顯示在地圖的左下方。地圖Logo不能移除，但可通過MAMapView.logoCenter屬性來調整Logo的顯示位置。在ViewController.m的viewDidLoad方法新增如下如下：

_mapView.logoCenter = CGPointMake(CGRectGetWidth(self.view.bounds)-55, 450);

3.1.2 指南針

指南針預設是開啟狀態，顯示在地圖的右上角。
通過MAMapView的showsCompass屬性用來控制指南針的可見性。compassOrigin屬性可改變指南針的顯示位置。在ViewController.m的viewDidLoad方法新增如下如下：

_mapView.showsCompass= YES; // 設定成NO表示關閉指南針；YES表示顯示指南針
_mapView.compassOrigin= CGPointMake(_mapView.compassOrigin.x, 22); //設定指南針位置

3.1.3 比例尺

比例尺表示地圖上兩點間距離與實際與之對應的兩點距離的比，在不同的縮放級別下，比例尺代表的長度也是不同的。
在iOS SDK中，比例尺預設顯示在地圖的左上角。MAMapView的showScale屬性用來控制比例尺的可見性，scaleOrigin屬性用來改變比例尺的顯示位置。在ViewController.m的viewDidLoad方法新增如下程式碼：

_mapView.showScale= YES;  //設定成NO表示不顯示比例尺；YES表示顯示比例尺
_mapView.scaleOrigin= CGPointMake(_mapView.scaleOrigin.x, 22);  //設定比例尺位置

3.1.4 手勢控制

縮放手勢

_mapView.zoomEnabled = NO;    //NO表示禁用縮放手勢，YES表示開啟

平移（滑動）手勢

_mapView.scrollEnabled = NO;    //NO表示禁用滑動手勢，YES表示開啟

旋轉手勢(3D)

_mapView.rotateEnabled= NO;    //NO表示禁用旋轉手勢，YES表示開啟

傾斜手勢(3D)

_mapView.rotateCameraEnabled= NO;    //NO表示禁用傾斜手勢，YES表示開啟

3.1.5 地圖操作

地圖縮放
地圖的縮放級別的範圍是[3-19]，呼叫MAMapView的setZoomLevel方法設定地圖的縮放級別，用來縮放地圖。示例程式碼如下：

[_mapView setZoomLevel:17.5 animated:YES];

地圖平移

[_mapView setCenterCoordinate:center animated:YES];

地圖旋轉（3D）
旋轉角度的範圍是[0.f 360.f]，以逆時針為正向。示例程式碼如下：

[_mapView setRotationDegree:60.f animated:YES duration:0.5];

地圖傾斜（3D）
傾斜角度範圍為[0.f, 45.f]，示例程式碼如下：

[_mapView setCameraDegree:30.f animated:YES duration:0.5];

3.1.6 地圖截圖

CGRect inRect = CGRectMake(80,142,160,284);
UIImage *screenshotImage = [_mapView takeSnapshotInRect:inRect] ;

3.2 衛星圖

//顯示衛星地圖
_mapView.mapType = MAMapTypeSatellite;

說明：地圖型別切換隻需將地圖型別設定成相應的型別（MAMapTypeStandard/MAMapTypeSatellite/MAMapTypeStandardNight）。

3.3 實時交通圖

顯示實時交通路況的程式碼如下：
_mapView.showTraffic= YES;

3.4 熱力圖圖層

3.5 自定義圖層

3.6 地Annotation（單點覆蓋物）（重點）

3.6.1 大頭針標註

地圖標註在開發中經常使用，並且地圖標註樣式靈活，需要著重注意。
在地圖的基礎，新增地圖標註，需要兩步
1. 建立地圖標註MAPointAnnotation，新增地圖標註[_mapView addAnnotation:annotation];
2. mapView:viewForAnnotation:回撥函式，設定標註樣式。
這裡新增標註的代理方法，也可以把當前位置當做標註一樣去顯示出來，比較靈活。

3.6.2 自定義標註

自定義標註圖示（基於大頭針標註，可以自定義樣式）

（1） 新增標註資料物件，可參考大頭針標註的步驟（1）。
（2） 匯入標記圖片檔案到工程中。這裡我們匯入一個名為restauant.png的圖片檔案。
（3） 在 協議的回撥函式mapView:viewForAnnotation:中修改MAAnnotationView對應的標註圖片。
關鍵程式碼：

annotationView.image = [UIImage imageNamed:@"restaurant"];
//設定中⼼心點偏移，使得標註底部中間點成為經緯度對應點
annotationView.centerOffset = CGPointMake(0, -18);

自定義氣泡

氣泡在iOS中又稱為callout，它由背景和氣泡內容構成。
（1） 新建自定義氣泡類CustomCalloutView，繼承UIView。
（2） 在CustomCalloutView.h中定義資料屬性，包含：圖片、商戶名和商戶地址。
（3） 在CustomCalloutView.m中重寫UIView的drawRect方法，繪製彈出氣泡的背景。
（4） 定義用於顯示氣泡內容的控制元件，並新增到SubView中。
（5） 在CustomCalloutView.m中給控制元件傳入資料。
詳見官方文件。

3.7 幾何圖形

3.8 地形圖圖層

3.9 熱力圖功能

3.10 自定義覆蓋物

3.11 OpenGL繪製功能

3.12 定位功能

3.12.1 簡介

iOS系統不允許使用第三方定位，地圖SDK的定位方法是對iOS系統定位的二次封裝。通過封裝。可將原始的定位點無偏差的顯示在高德地圖上。同時，可自定義定點陣圖標和精度圈的樣式。

3.12.2 注意

1)2.3.0(含)之前版本的SDK，在iOS8中無法定位，請參考：iOS8無法定位的解決方案。
2)2.4.0(含)以後版本需在info.plist中追加NSLocationWhenInUseUsageDescription或NSLocationAlwaysUsageDescription欄位.其中：
NSLocationWhenInUseUsageDescription表示應用在前臺的時候可以搜到更新的位置資訊。
NSLocationAlwaysUsageDescription表示應用在前臺和後臺（suspend或terminated）都可以獲取到更新的位置資料。
特別注意：在plist檔案中加上之後如果無效，請在info頁面加上

3.12.3 開啟定位

_mapView.showsUserLocation = YES; //YES 為開啟定位，NO為關閉定位
當位置更新時，會進定位回撥，通過回撥函式，能獲取到定位點的經緯度座標：

-(void)mapView:(MAMapView*)mapView didUpdateUserLocation: (MAUserLocation*)userLocation updatingLocation:(BOOL)updatingLocation

3.12.4 定點陣圖層

定位的樣式是可以更改的，方式與標註類似。

3.12.5 後臺定位

app退到後臺，且位置不變動時，也不會被系統掛起，可持久記錄位置資訊。

1.新增程式碼。

_mapView.pausesLocationUpdatesAutomatically = NO;

2.工程配置。

a)左側目錄中選中工程名，開啟 TARGETS->Capabilities->Background Modes
b)在 Background Modes中勾選 Location updates

3.13 檢索功能

注意事項

高德地圖暫不支援多地圖例項，需要共用一個mapView。

參考資料