Localizar o mapa

Para personalizar as configurações de idioma e região usadas no mapa, mude o ambiente de localidade no Map, o que pode afetar os rótulos e o comportamento do mapa com base no idioma e no país ou território especificados.

Confira a cobertura do SDK do Maps 3D para iOS na tabela de cobertura do Maps.

Localização de idioma

Por padrão, o SDK do Maps 3D para iOS usa a localidade do sistema configurada no dispositivo do usuário (Locale.current) para determinar qual tradução do mapa será mostrada. É possível modificar esse comportamento padrão aplicando o modificador .environment(\.locale, ...) do SwiftUI à visualização Map ou atualizando a variável de estado Locale vinculada de forma dinâmica no momento da execução.

Definir o idioma afeta a tradução de características políticas, descritores e características naturais, como mudar "Genebra" para "Genève" ou "lago" para "lac", e muda a direção em que o texto é renderizado para scripts da direita para a esquerda.

O SDK do Maps 3D para iOS procura preferências de localização na seguinte ordem:

  1. Ambiente do SwiftUI: o valor Locale transmitido para .environment(\.locale, ...) em Map.
  2. Configurações do dispositivo: a localidade padrão do sistema configurada no dispositivo iOS.

O exemplo a seguir mostra um Map em chinês ("zh") e define a região como China ("CN"):

import GoogleMaps3D
import SwiftUI

struct ContentView: View {
  var body: some View {
    Map(mode: .hybrid)
      .environment(\.locale, Locale(identifier: "zh-CN"))
  }
}

Também é possível atualizar o idioma e a região dinamicamente durante a execução vinculando a localidade do ambiente a uma propriedade @State:

import GoogleMaps3D
import SwiftUI

struct LocalizationExampleView: View {
  @State private var mapLocale: Locale = .current

  var body: some View {
    VStack {
      Map(mode: .hybrid)
        .environment(\.locale, mapLocale)

      HStack {
        Button("Français") {
          mapLocale = Locale(identifier: "fr-FR")
        }
        Button("日本語") {
          mapLocale = Locale(identifier: "ja-JP")
        }
        Button("中文") {
          mapLocale = Locale(identifier: "zh-CN")
        }
      }
    }
  }
}

Localização de regiões

Definir a região no Locale transmitido para .environment(\.locale, ...) em Map pode exibir blocos de mapas diferentes ou priorizar resultados adequados para a região. Definir a região também ajuda a garantir que o app aplique a localização regional para o país ou território em que ele é distribuído.

Para manter o idioma do dispositivo do usuário ao definir um código de região específico (por exemplo, "JP"), crie um Locale usando Locale.Components:

var components = Locale.Components(locale: Locale.current)
components.region = Locale.Region("JP")
let regionBiasedLocale = Locale(components: components)