Offline routing

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "thirdparty/osrm-text-instructions"]
+	path = thirdparty/osrm-text-instructions
+	url = https://github.com/Project-OSRM/osrm-text-instructions.git

Cartfile

@@ -1,6 +1,6 @@
 binary "https://www.mapbox.com/ios-sdk/Mapbox-iOS-SDK.json" ~> 4.3
 binary "https://www.mapbox.com/ios-sdk/MapboxNavigationNative.json" ~> 3.2
-github "mapbox/MapboxDirections.swift" ~> 0.24
+github "mapbox/MapboxDirections.swift" ~> 0.24.1
 github "mapbox/turf-swift" ~> 0.2
 github "mapbox/mapbox-events-ios" ~> 0.6
 github "ceeK/Solar" ~> 2.1.0

MapboxCoreNavigation.podspec

@@ -41,7 +41,7 @@ Pod::Spec.new do |s|
   s.module_name = "MapboxCoreNavigation"
 
   s.dependency "MapboxNavigationNative", "~> 3.2.0"
-  s.dependency "MapboxDirections.swift", "~> 0.24.0"    # Always pin to a patch release if pre-1.0
+  s.dependency "MapboxDirections.swift", "~> 0.24.1"    # Always pin to a patch release if pre-1.0
   s.dependency "MapboxMobileEvents", "~> 0.6.0"         # Always pin to a patch release if pre-1.0
   s.dependency "Turf", "~> 0.2.0"                       # Always pin to a patch release if pre-1.0
 

MapboxCoreNavigation/MBRouteController.h

@@ -1,4 +1,5 @@
 #import <Foundation/Foundation.h>
+#import <MapboxNavigationNative/MapboxNavigationNative.h>
 
 /**
  Posted when `MBRouteController` receives a user location update representing movement along the expected route.
@@ -82,3 +83,4 @@ extern const MBRouteControllerNotificationUserInfoKey MBRouteControllerIsProacti
 @interface NSString (MD5)
 - (NSString * _Nonnull)md5;
 @end
+

MapboxCoreNavigation/MBRouteController.m

@@ -16,6 +16,10 @@
 
 NSString *const MBErrorDomain = @"ErrorDomain";
 
+typedef NS_ENUM(NSInteger, MBNavigationError) {
+    MBErrorCodeUnknown = -1,
+};
+
 @implementation NSString (MD5)
 - (NSString * _Nonnull)md5 {
     const char *cStr = [self UTF8String];
@@ -30,3 +34,4 @@ - (NSString * _Nonnull)md5 {
     return  output;
 }
 @end
+

MapboxCoreNavigation/OfflineDirections.swift

@@ -0,0 +1,119 @@
+import Foundation
+import MapboxDirections
+import MapboxNavigationNative
+
+public typealias OfflineDirectionsCompletionHandler = (_ numberOfTiles: UInt64) -> Void
+
+public enum OfflineRoutingError: Error {
+    case unexpectedRouteResult
+    case corruptRouteData
+    case responseError(String)
+}
+
+struct OfflineDirectionsConstants {
+    static let offlineSerialQueueLabel = Bundle.mapboxCoreNavigation.bundleIdentifier!.appending(".offline")
+    static let serialQueue = DispatchQueue(label: OfflineDirectionsConstants.offlineSerialQueueLabel)
+}
+
+/**
+ Defines additional functionality similar to `Directions` with support for offline routing.
+ */
+@objc(MBOfflineDirectionsProtocol)
+public protocol OfflineRoutingProtocol {
+
+    /**
+     Initializes a newly created directions object with an optional access token and host.
+
+     - parameter tilesPath: The location where the tiles has been sideloaded to.
+     - parameter translationsPath: The location where the translations has been sideloaded to.
+     - parameter accessToken: A Mapbox [access token](https://www.mapbox.com/help/define-access-token/). If an access token is not specified when initializing the directions object, it should be specified in the `MGLMapboxAccessToken` key in the main application bundle’s Info.plist.
+     - parameter host: An optional hostname to the server API. The [Mapbox Directions API](https://www.mapbox.com/api-documentation/?language=Swift#directions) endpoint is used by default.
+     */
+    init(tilesPath: URL, translationsPath: URL, accessToken: String?, host: String?, completionHandler: @escaping OfflineDirectionsCompletionHandler)
+
+    /**
+     Begins asynchronously calculating the route or routes using the given options and delivers the results to a closure.
+
+     This method retrieves the routes asynchronously via MapboxNavigationNative.
+
+     Routes may be displayed atop a [Mapbox map](https://www.mapbox.com/maps/). They may be cached but may not be stored permanently. To use the results in other contexts or store them permanently, [upgrade to a Mapbox enterprise plan](https://www.mapbox.com/directions/#pricing).
+
+     - parameter options: A `RouteOptions` object specifying the requirements for the resulting routes.
+     - parameter completionHandler: The closure (block) to call with the resulting routes. This closure is executed on the application’s main thread.
+     */
+    func calculateOffline(_ options: RouteOptions, completionHandler: @escaping Directions.RouteCompletionHandler)
+}
+
+@objc(MBMapboxOfflineDirections)
+public class MapboxOfflineDirections: Directions, OfflineRoutingProtocol {
+
+    public required init(tilesPath: URL, translationsPath: URL, accessToken: String?, host: String? = nil, completionHandler: @escaping OfflineDirectionsCompletionHandler) {
+
+        super.init(accessToken: accessToken, host: host)
+
+        OfflineDirectionsConstants.serialQueue.sync {
+            let tilesPath = tilesPath.absoluteString.replacingOccurrences(of: "file://", with: "")
+            let translationsPath = translationsPath.absoluteString.replacingOccurrences(of: "file://", with: "")
+            let tileCount = self.navigator.configureRouter(forTilesPath: tilesPath, translationsPath: translationsPath)
+
+            DispatchQueue.main.async {
+                completionHandler(tileCount)
+            }
+        }
+    }
+
+    public func calculateOffline(_ options: RouteOptions, completionHandler: @escaping Directions.RouteCompletionHandler) {
+
+        let url = self.url(forCalculating: options)
+
+        OfflineDirectionsConstants.serialQueue.sync { [weak self] in
+
+            guard let result = self?.navigator.getRouteForDirectionsUri(url.absoluteString) else {
+                return completionHandler(nil, nil, OfflineRoutingError.unexpectedRouteResult as NSError)
+            }
+
+            guard let data = result.json.data(using: .utf8) else {
+                return completionHandler(nil, nil, OfflineRoutingError.corruptRouteData as NSError)
+            }
+
+            do {
+                let json = try JSONSerialization.jsonObject(with: data, options: []) as! [String: Any]
+                if let errorValue = json["error"] as? String {
+                    DispatchQueue.main.async {
+                        let error = NSError(domain: "..", code: 102, userInfo: [NSLocalizedDescriptionKey: errorValue])
+                        return completionHandler(nil, nil, error)
+                    }
+                } else {
+                    let response = options.response(from: json)
+
+                    DispatchQueue.main.async {
+                        return completionHandler(response.0, response.1, nil)
+                    }
+                }
+
+            } catch {
+                DispatchQueue.main.async {
+                    return completionHandler(nil, nil, error as NSError)
+                }
+            }
+        }
+    }
+
+    var _navigator: MBNavigator!
+    var navigator: MBNavigator {
+
+        assert(currentQueueName() == OfflineDirectionsConstants.offlineSerialQueueLabel,
+               "The offline navigator must be accessed from the dedicated serial queue")
+
+        if _navigator == nil {
+            self._navigator = MBNavigator()
+        }
+
+        return _navigator
+    }
+}
+
+fileprivate func currentQueueName() -> String? {
+    let name = __dispatch_queue_get_label(nil)
+    return String(cString: name, encoding: .utf8)
+}

MapboxCoreNavigationTests/CocoaPodsTest/PodInstall/Podfile.lock

@@ -1,7 +1,7 @@
 PODS:
   - Mapbox-iOS-SDK (4.5.0)
   - MapboxCoreNavigation (0.23.0):
-    - MapboxDirections.swift (~> 0.24.0)
+    - MapboxDirections.swift (~> 0.24.1)
     - MapboxMobileEvents (~> 0.6.0)
     - MapboxNavigationNative (~> 3.2.0)
     - Turf (~> 0.2.0)

MapboxCoreNavigationTests/OfflineRoutingTests.swift

@@ -0,0 +1,73 @@
+import XCTest
+import MapboxDirections
+@testable import MapboxCoreNavigation
+
+class OfflineRoutingTests: XCTestCase {
+
+    func testOfflineDirections() {
+        let bundle = Bundle(for: OfflineRoutingTests.self)
+        let tilesPath = URL(fileURLWithPath: bundle.bundlePath.appending("/routing/liechtenstein"))
+        let translationsPath = URL(fileURLWithPath: bundle.bundlePath.appending("/translations"))
+
+        let setupExpectation = expectation(description: "Set up offline routing")
+
+        let directions = MapboxOfflineDirections(tilesPath: tilesPath, translationsPath: translationsPath, accessToken: "foo") { (numberOfTiles) in
+            XCTAssertEqual(numberOfTiles, 5)
+            setupExpectation.fulfill()
+        }
+
+        wait(for: [setupExpectation], timeout: 2)
+
+        // Coordinates within Liechtenstein
+        let coordinates = [CLLocationCoordinate2D(latitude: 47.1192, longitude: 9.5412),
+                           CLLocationCoordinate2D(latitude: 47.1153, longitude: 9.5531)]
+
+        let options = NavigationRouteOptions(coordinates: coordinates, profileIdentifier: .automobile)
+        let calculateRouteExpectation = expectation(description: "Calculate route offline")
+        var route: Route?
+
+        directions.calculateOffline(options) { (waypoints, routes, error) in
+            XCTAssertNil(error)
+            XCTAssertNotNil(waypoints)
+            XCTAssertNotNil(routes)
+            route = routes!.first!
+            calculateRouteExpectation.fulfill()
+        }
+
+        wait(for: [calculateRouteExpectation], timeout: 2)
+
+        XCTAssertNotNil(route)
+        XCTAssertEqual(route!.coordinates!.count, 239)
+    }
+
+    func testOfflineDirectionsError() {
+        let bundle = Bundle(for: OfflineRoutingTests.self)
+        let tilesPath = URL(fileURLWithPath: bundle.bundlePath).appendingPathComponent("/routing/liechtenstein")
+        let translationsPath = URL(fileURLWithPath: bundle.bundlePath).appendingPathComponent("/translations")
+
+        let setupExpectation = expectation(description: "Set up offline routing")
+
+        let directions = MapboxOfflineDirections(tilesPath: tilesPath, translationsPath: translationsPath, accessToken: "foo") { (numberOfTiles) in
+            XCTAssertEqual(numberOfTiles, 5)
+            setupExpectation.fulfill()
+        }
+
+        wait(for: [setupExpectation], timeout: 2)
+
+        // Coordinates in SF
+        let coordinates = [CLLocationCoordinate2D(latitude: 37.7870, longitude: -122.4261),
+                           CLLocationCoordinate2D(latitude: 37.7805, longitude: -122.4073)]
+
+        let options = NavigationRouteOptions(coordinates: coordinates, profileIdentifier: .automobile)
+        let calculateRouteExpectation = expectation(description: "Calculate route offline")
+
+        directions.calculateOffline(options) { (waypoints, routes, error) in
+            XCTAssertNotNil(error)
+            XCTAssertNil(routes)
+            XCTAssertNil(waypoints)
+            calculateRouteExpectation.fulfill()
+        }
+
+        wait(for: [calculateRouteExpectation], timeout: 2)
+    }
+}