使用 MapKit 绘制路线

作者：Arthur Knopper，原文链接，原文日期：2016-02-29
译者：TonyHan；校对：Crystal Sun；定稿：CMB

在本节教程中，将学习如何在纽约市的两个地标之间绘制一条线路。这条线路绘制在 Map 图层的上面，使用折线绘制。本教程使用 Xcode 7.2 和 iOS 9.2。

译者注：由于目前主流版本为 Xcode 8（iOS 10），因此图示可能会有所不同，不过不影响对于文章的理解。基于此版本的项目可以在这里下载到。

打开 Xcode 创建 Single View Application。使用 IOS9DrawRouteMapKitTutorial 作为项目名，然后根据实际情况填写 Organization Name 和 Organization Identifier。选择 Swift 作为编程语言，Devices 选择只适配 iPhone。

image1

在项目导航栏中，选择 Prokect Settings 图标。点击 Capabilities 栏并启用 Map framework。

image2

打开 Storyboard，选择 View Controller，打开 Editor 菜单并选择 Embed in -> Navigation Controller。双击 View Controller 的 Navigation Bar 并输入 “Route Tutorial”。接下来，从视图对象库中拖拽 Map Kit View 到主视图中。重新设置尺寸，让其填充整个屏幕。现在 Storyboard 如下图所示：

image3

打开 Assistant Editor，确保 ViewController.swift 文件可见。按住 control 键将 Map Kit View 拖动到 ViewController 类中，创建如下图所示的 Outlet：

image4

选择 Map Kit View，并点击在 Interface Builder 右下角的 Pin 图标（左边起第三个）。四边都设置约束，并反选 “Constrain to margins”。点击 “Add 4 Constraints” 按钮，于是 Map Kit View 在各方向上边缘都与主视图对齐。

image5

打开 Assistant Editor，确保 ViewController.swift 文件可见。选择 Map Kit View。按住 control 键将 Map Kit View 拖动到 ViewController 类中，创建的 Outlet。

译者注：这一段内容与上面的创建 Outlet 内容有重复，上面那一段及后面的图片应该在此处。因原文如此，故在此未改。

打开 ViewController.swift，添加 MapKit framework。

import MapKit

View Controller 需要遵循 MKMapViewDelegate 协议，才能实现路线的绘制。将类声明的代码修改为：

class ViewController: UIViewController, MKMapViewDelegate {

然后，将 viewDidLoad 方法修改为：

override func viewDidLoad() {
    super.viewDidLoad()
    
    // 1.
    mapView.delegate = self
    
    // 2.
    let sourceLocation = CLLocationCoordinate2D(latitude: 40.759011, longitude: -73.984472)
    let destinationLocation = CLLocationCoordinate2D(latitude: 40.748441, longitude: -73.985564)
    
    // 3.
    let sourcePlacemark = MKPlacemark(coordinate: sourceLocation, addressDictionary: nil)
    let destinationPlacemark = MKPlacemark(coordinate: destinationLocation, addressDictionary: nil)
    
    // 4.
    let sourceMapItem = MKMapItem(placemark: sourcePlacemark)
    let destinationMapItem = MKMapItem(placemark: destinationPlacemark)
    
    // 5.
    let sourceAnnotation = MKPointAnnotation()
    sourceAnnotation.title = "Times Square"
    
    if let location = sourcePlacemark.location {
        sourceAnnotation.coordinate = location.coordinate
    }
    
    
    let destinationAnnotation = MKPointAnnotation()
    destinationAnnotation.title = "Empire State Building"
    
    if let location = destinationPlacemark.location {
        destinationAnnotation.coordinate = location.coordinate
    }
    
    // 6.
    self.mapView.showAnnotations([sourceAnnotation,destinationAnnotation], animated: true )
    
    // 7.
    let directionRequest = MKDirectionsRequest()
    directionRequest.source = sourceMapItem
    directionRequest.destination = destinationMapItem
    directionRequest.transportType = .Automobile
    
    // 计算方向
    let directions = MKDirections(request: directionRequest)
    
    // 8.
    directions.calculateDirectionsWithCompletionHandler {
        (response, error) -> Void in
        
        guard let response = response else {
            if let error = error {
                print("Error: \(error)")
            }
            
            return
        }
        
        let route = response.routes[0]
        self.mapView.addOverlay((route.polyline), level: MKOverlayLevel.AboveRoads)
        
        let rect = route.polyline.boundingMapRect
        self.mapView.setRegion(MKCoordinateRegionForMapRect(rect), animated: true)
    }
}

1. ViewController 作为 MKMapViewDelegate 协议的代理
2. 设置地点的经纬度
3. 创建包含地点坐标的地标对象
4. 使用 MKMapitems 标记路径。该类封装了有关地图上特定点的信息
5. 添加显示地标名字的大头针
6. 在地图上显示大头针
7. 使用 MKDirectionsRequest 类计算路径
8. 使用折线在地图图层上面绘制出路径。该区域设置为两个位置都可见

接下来，实现代理方法 mapView(rendererForrOverlay:)：

func mapView(mapView: MKMapView, rendererForOverlay overlay: MKOverlay) -> MKOverlayRenderer {
    let renderer = MKPolylineRenderer(overlay: overlay)
    renderer.strokeColor = UIColor.redColor()
    renderer.lineWidth = 4.0

    return renderer
}

这个方法返回用于返回绘制在地图上的渲染对象。使用宽度为 4 的红色线条。

运行 项目，展示出两个地点及其之间的路线。

image6

可以从 Github 上 ioscreator 的仓库中下载 IOS9DrawRouteMapKitTutorial 项目的源代码作为参考。

译者注：由于目前主流版本为 Xcode 8（iOS 10），因此图示可能会有所不同，不过不影响对于文章的理解。基于此版本的项目可以在这里下载到。

本文由 SwiftGG 翻译组翻译，已经获得作者翻译授权，最新文章请访问 http://swift.gg。