Add language/locale

MapboxDirections/MBRouteOptions.swift

@@ -181,6 +181,8 @@ open class RouteOptions: NSObject, NSSecureCoding {
         self.attributeOptions = attributeOptions
 
         includesExitRoundaboutManeuver = decoder.decodeBool(forKey: "includesExitRoundaboutManeuver")
+
+        locale = Locale(identifier: decoder.decodeObject(of: NSString.self, forKey: "locale") as String? ?? "")
     }
 
     open static var supportsSecureCoding = true
@@ -195,6 +197,9 @@ open class RouteOptions: NSObject, NSSecureCoding {
         coder.encode(routeShapeResolution.description, forKey: "routeShapeResolution")
         coder.encode(attributeOptions.description, forKey: "attributeOptions")
         coder.encode(includesExitRoundaboutManeuver, forKey: "includesExitRoundaboutManeuver")
+        if let locale = locale, let languageCode = (locale as NSLocale?)?.object(forKey: .languageCode) as? String {
+            coder.encode(languageCode, forKey: "locale")
+        }
     }
 
     // MARK: Specifying the Path of the Route
@@ -303,6 +308,13 @@ open class RouteOptions: NSObject, NSSecureCoding {
      */
     open var includesExitRoundaboutManeuver = false
 
+    /**
+     If set, this `Locale` will be used to translate instructions.
+
+     See supported languages [here](https://www.mapbox.com/api-documentation/#instructions-languages).
+     */
+    open var locale: Locale?
+
     /**
      An array of URL parameters to include in the request URL.
      */
@@ -319,6 +331,10 @@ open class RouteOptions: NSObject, NSSecureCoding {
             params.append(URLQueryItem(name: "roundabout_exits", value: String(includesExitRoundaboutManeuver)))
         }
 
+        if let locale = locale, let languageCode = (locale as NSLocale?)?.object(forKey: .languageCode) as? String {
+            params.append(URLQueryItem(name: "language", value: languageCode))
+        }
+
         // Include headings and heading accuracies if any waypoint has a nonnegative heading.
         if !waypoints.filter({ $0.heading >= 0 }).isEmpty {
             let headings = waypoints.map { $0.headingDescription }.joined(separator: ";")

MapboxDirectionsTests/RouteOptionsTests.swift

@@ -10,6 +10,7 @@ class RouteOptionsTests: XCTestCase {
         ]
 
         let options = RouteOptions(coordinates: coordinates, profileIdentifier: .automobileAvoidingTraffic)
+        options.locale = Locale(identifier: "en")
 
         let encodedData = NSMutableData()
         let keyedArchiver = NSKeyedArchiver(forWritingWith: encodedData)
@@ -34,5 +35,6 @@ class RouteOptionsTests: XCTestCase {
         XCTAssertEqual(unarchivedWaypoints[2].coordinate.longitude, coordinates[2].longitude)
 
         XCTAssertEqual(unarchivedOptions.profileIdentifier, options.profileIdentifier)
+        XCTAssertEqual(unarchivedOptions.locale, options.locale)
     }
 }