Unable to Change Map Language: localizeLabels(into:forLayerIds:) Method Not Working

[Savva-Shuliatev]

Environment

• Xcode version: Version 16.2 (16C5032a)
• iOS version: 18+
• Devices affected: All
• Maps SDK Version: 11.9.0

Observed behavior and steps to reproduce

localizeLabels(into:forLayerIds:) Method Not Working

Simplest example:

import UIKit
import Combine
import MapboxMaps

class ViewController: UIViewController {

  private lazy var mapView = MapView(frame: .zero)

  private var cancellables: Set<AnyCancellable> = []

  override func viewDidLoad() {
    super.viewDidLoad()
    view.addSubview(mapView)
    mapView.frame = view.bounds

    preconditionFailure("Set your accessToken!")
    MapboxOptions.accessToken = ""

    mapView.mapboxMap.onMapLoaded.observe { [weak self] _ in
      /// https://docs.mapbox.com/help/troubleshooting/change-language/#mapbox-maps-sdk-for-ios
      try! self!.mapView.mapboxMap.localizeLabels(into: Locale(identifier: "ar"))
      /// No effect
    }
    .store(in: &cancellables)
  }

}

Expected behavior

Based on the documentation, I expect a change in language.
https://docs.mapbox.com/help/troubleshooting/change-language/#mapbox-maps-sdk-for-ios

Additional links and references

Demo project with bug https://github.com/Savva-Shuliatev/Mapbox-localization-bug

[Savva-Shuliatev]

I found an alternative solution with setting the language:

let locale = Locale.current
let settingsService = SettingsServiceFactory.getInstance(storageType: .persistent)
switch settingsService.set(key: MapboxCommonSettings.language, value: "\(locale)") {
case .success:
 print("Successfully set MapboxCommonSettings.language \(locale)")
case .failure(let error):
 assertionFailure("Failed to set MapboxCommonSettings.language with error: \(error)")
}

This works in my project and in the demo project. https://github.com/Savva-Shuliatev/Mapbox-localization-bug
Thanks to the following article: https://www.mapbox.com/blog/maps-internationalization-34-languages

But, How safe is it to use this approach?

[pjleonard37]

Hi @Savva-Shuliatev --

Thanks for the report. You are correct that .localizeLabels() does not work for Mapbox Standard (our default style) or Mapbox Satellite Standard. We have an open issue for this here that you can use to follow updates. In short, Mapbox Standard introduced a new basemap approach that changed how layers are handled at runtime. As you've identified, this means that the .localizeLabels() approach to translating map labels does not work for these styles.

If translation using .localizeLabels() is important for your project, I recommend creating a style based on one of our classic styles, such as Mapbox Streets.

The alternative approach you identified here using MapboxCommonSettings remains in preview so we do not recommend it for production applications.