深入探索MapKit开发：从基础设置到功能实现

### 深入探索 MapKit 开发：从基础设置到功能实现 #### 1. 前期准备：创建注解类 在开始项目搭建时，需要创建一个注解类，用于控制地图上的注解。以标记 UCCS 工程与应用科学大楼的前门为例，要创建一个 Objective - C 类来控制注解的所有特性。具体操作步骤如下： 1. 右键点击 `myMapkit_02` 主项目文件夹，选择“New File”，确保选择“Objective - C class”。 2. 将这个控制器命名为 `myPos`，它是 `NSObject` 的子类，而非 `UIView` 或其他子类。 3. 将新文件保存到项目的子文件夹 `myMapkit_02` 中，默认会显示该文件夹，点击“Create”即可。 4. 把新创建的 `myPos.h` 和 `myPos.m` 文件移动到 `Supporting Files` 文件夹上方的正确位置。 5. 检查项目，确保以下条件都满足： - `NSObject` 文件 `myPos.h` 和 `myPos.m` 在 `myMapkit_02` 目录中。 - 图标和启动屏幕在 `Supporting Files` 文件夹中。 - `MapKit.framework` 的引用在 `Frameworks` 文件夹中。 #### 2. 编写 myPos 注解类代码 现在开始编写 `myPos` 注解类的代码。虽然在某些小应用中不一定非要对 `myPos.h` 和 `myPos.m` 文件进行编程，但习惯创建 `NSObject` 的 `myPos` 类来跟踪位置或位置数组是很有必要的。 1. **编辑 myPos.h 文件**： - 打开 `myPos.h` 文件，初始代码如下： ```objective - c #import <Foundation/Foundation.h> @interface myPos : NSObject @end ``` - 进行以下修改： - 添加 MapKit 框架：在 `@interface myPos : NSObject` 指令中添加 `#import <MapKit/MkAnnotation.h>`。 - 添加协议：添加 `<MKAnnotation>` 协议，采用该协议的对象必须实现 `coordinate` 属性。 - 设置 CLLocation 类引用：添加 `CLLocationCoordinate2D coordinate;` 以包含设备的地理坐标和海拔。 - 定义标题和副标题变量：添加 `NSString *title;` 和 `NSString *subtitle;`。 - 创建属性声明： ```objective - c #import <Foundation/Foundation.h> #import <MapKit/MkAnnotation.h> @interface myPos : NSObject <MKAnnotation> { CLLocationCoordinate2D coordinate; NSString *title; NSString *subtitle; } @property (nonatomic, assign) CLLocationCoordinate2D coordinate; @property (nonatomic, copy) NSString *title; @property (nonatomic, copy) NSString *subtitle; @end ``` 2. **编辑 myPos.m 文件**： - 打开 `myPos.m` 文件，在 `mypos.h @implementation` 下方添加以下代码进行属性合成： ```objective - c @synthesize coordinate, title, subtitle; ``` #### 3. 用户界面设计 用户与应用交互的机制称为用户界面（UI），这里要在视图控制器中进行可视化设计。操作步骤如下： 1. 从项目导航窗口中点击 `ViewController.xib`，Xcode 会自动进入 Interface Builder。此时视图控制器的画布为空，在窗口右下角的对象库列表中找到 `Map View (MKMapView)` 控件，将其拖到 iPad 视图控制器上。 2. 拖动 `Map View` 到画布上时，它会变成一个全屏的蓝色空白图像，将其大致居中后放下。 3. 为了能以编程方式访问 `Map View`，需要添加一个出口。点击相应的工具栏按钮打开助理编辑器，会看到 `ViewController.h` 文件的代码。 4. 将鼠标指针移到刚放置 `Map View` 的视图控制器画布上，按住 `Control` 键并拖动到右侧的头文件中，会出现一条“钓鱼线”，将其拖到 `@interface ViewController: UIViewController` 下方放下，创建出口。 5. 将出口命名为 `mapView`，保持对话框中的其他默认选项不变，按 `Enter` 键或点击“Connect”创建出口。 6. 点击工具栏中助理编辑器左侧的标准编辑器按钮关闭助理编辑器，完成 Interface Builder 的操作。 #### 4. 编写视图控制器代码 接下来开始编写视图控制器的代码。可以使用 `DemoMonkey` 中的样板代码来加快编码速度，也可以手动输入代码。 1. **编辑 ViewController.h 文件**： - 打开 `ViewController.h` 文件，删除其中的所有代码。 - 可以从 `DemoMonkey` 窗口中选择 `03 ViewController.h` 代码并拖放到代码编辑器窗口中。手动输入的代码如下： ```objective - c #import <UIKit/UIKit.h> #import <MapKit/MapKit.h> #import "myPos.H" @interface ViewController : UIViewController<MKMapViewDelegate> @property (weak, nonatomic) IBOutlet MKMapView *mapView; @end MKCoordinateRegion uccsRegion; // buttons that will be on our navigation toolbar UIBarButtonItem *mapLayer1Button; UIBarButtonItem *mapLayer2Button; UIBarButtonItem *mapLayer3Button; UIBarButtonItem *userLocationButton; UIBarButtonItem *uccsLocationButton; ``` - 代码解释： - `#import <MapKit/MapKit.h>`：导入 MapKit 框架的所有必要代码。 - `<MKMapViewDelegate>` 协议：用于更新应用中位置的记录。 - `@property (weak, nonatomic) IBOutlet MKMapView *mapView`：同时定义出口和属性。 - `MKCoordinateRegion uccsRegion`：定义一个专注于 UCCS 区域的地图区域。 - 定义导航工具栏上的按钮：`UIBarButtonItem` 类让用户可以与应用交互。 2. 保存文件，完成视图控制器头文件的编写。 #### 5. 处理视图控制器的实现 使用 MapKit 框架进行控制和开发并非易事，但完成本部分内容后会有所收获。在导入 `myPos` 头文件并合成视图控制器后，还需要完成以下操作： 1. 在 `viewDidLoad` 方法中设置 UCCS 工程与应用科学大楼的坐标。 2. 在 `viewDidAppear` 方法中设置工具栏按钮，并将它们添加到应用顶部的主导航栏中。 3. 在 `viewDidAppear` 方法中，让一个图钉落在指定的经纬度上，并添加注解表明这是 Dr. Lewis 的办公室。 4. 在 `viewDidAppear` 方法中，让地图视图显示用户的当前位置。 5. 当用户点击导航栏中的按钮时，做出相应响应。 地图视图有三种显示方式： |显示方式|描述| | ---- | ---- | |Standard|显示带有街道名称和其他详细信息的典型地图视图。| |Satellite|显示从地球轨道卫星上看到的俯瞰视图。| |Hybrid|显示标准视图和卫星视图的组合视图。| 默认将地图类型设置为混合地图，但用户可以通过点击三个按钮之一来更改。也可以将 UCCS 的经纬度替换为其他位置的坐标，只需提前准备好这些坐标，可以从相关网站、Google Earth 或 Google Maps 获取。 接下来编写 `viewController.m` 文件： 1. 打开 `viewController.m` 文件，删除默认代码。可以从 `DemoMonkey` 中拖动 `Chapter