Add language/locale

MapboxDirections/MBRouteOptions.swift

@@ -181,6 +181,11 @@ open class RouteOptions: NSObject, NSSecureCoding {
         self.attributeOptions = attributeOptions
 
         includesExitRoundaboutManeuver = decoder.decodeBool(forKey: "includesExitRoundaboutManeuver")
+
+        guard let locale = decoder.decodeObject(of: NSLocale.self, forKey: "locale") as Locale? else {
+            return nil
+        }
+        self.locale = locale
     }
 
     open static var supportsSecureCoding = true
@@ -195,6 +200,7 @@ open class RouteOptions: NSObject, NSSecureCoding {
         coder.encode(routeShapeResolution.description, forKey: "routeShapeResolution")
         coder.encode(attributeOptions.description, forKey: "attributeOptions")
         coder.encode(includesExitRoundaboutManeuver, forKey: "includesExitRoundaboutManeuver")
+        coder.encode(locale, forKey: "locale")
     }
 
     // MARK: Specifying the Path of the Route
@@ -303,6 +309,15 @@ 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?
+
+    private let supportedLocales: [String] = ["de", "en", "es", "fr", "id", "nl", "ru", "sv", "vi", "zh-hans"]
+
     /**
      An array of URL parameters to include in the request URL.
      */
@@ -319,6 +334,14 @@ 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 {
+            if supportedLocales.contains(languageCode) {
+                params.append(URLQueryItem(name: "language", value: languageCode))
+            } else {
+                params.append(URLQueryItem(name: "language", value: "en"))
+            }
+        }
+
         // 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)
     }
 }