Offline routing

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,9 @@ extern const MBRouteControllerNotificationUserInfoKey MBRouteControllerIsProacti
 @interface NSString (MD5)
 - (NSString * _Nonnull)md5;
 @end
+
+@interface MBNavigator (additions)
+
+- (NSUInteger)setupRouter:(NSString *)tilesPath translationsPath:(NSString *)translationsPath;
+
+@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,16 @@ - (NSString * _Nonnull)md5 {
     return  output;
 }
 @end
+
+@implementation MBNavigator (additions)
+
+- (NSUInteger)setupRouter:(NSString *)tilesPath translationsPath:(NSString *)translationsPath {
+
+    @try {
+        return [self configureRouterForTilesPath:tilesPath translationsPath:translationsPath];
+    } @catch (NSException *exception) {
+        return -1;
+    }
+}
+
+@end

MapboxCoreNavigation/OfflineDirections.swift

@@ -0,0 +1,116 @@
+import Foundation
+import MapboxDirections
+import MapboxNavigationNative
+
+public typealias OfflineDirectionsCompletionHandler = (_ numberOfTiles: UInt) -> 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)
+}
+
+@objc(MBOfflineDirectionsProtocol)
+public protocol OfflineDirectionsProtocol {
+
+    /**
+     Initializes a newly created directions object with an optional access token and host.
+
+     - 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.
+     - parameter tilesPath: The location where the tiles has been sideloaded to.
+     - parameter translationsPath: The location where the translations has been sideloaded to.
+     */
+    init(accessToken: String?, host: String?, tilesPath: String, translationsPath: 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, OfflineDirectionsProtocol {
+
+    required public init(accessToken: String?, host: String?, tilesPath: String, translationsPath: String, completionHandler: @escaping OfflineDirectionsCompletionHandler) {
+
+        super.init(accessToken: accessToken, host: host)
+
+        OfflineDirectionsConstants.serialQueue.sync {
+            let tilesPath = tilesPath.replacingOccurrences(of: "file://", with: "")
+            let translationsPath = translationsPath.replacingOccurrences(of: "file://", with: "")
+            let tileCount = self.navigator.setupRouter(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)