Localizzare la mappa

Puoi personalizzare le impostazioni della lingua e della regione utilizzate nella mappa modificando le impostazioni della lingua predefinite e il codice della regione della mappa, che può influire sul comportamento della mappa in base al paese o al territorio specificato.

Consulta la copertura di Maps 3D SDK for Android nella tabella di copertura di Maps.

Localizzazione della lingua

Per impostazione predefinita, Maps 3D SDK for Android utilizza le impostazioni della lingua configurate sul dispositivo dell'utente per determinare quale traduzione della mappa visualizzare. Tuttavia, puoi ignorare questo comportamento predefinito e impostare una lingua specifica durante l'inizializzazione della mappa oppure aggiornare la lingua e la regione in modo dinamico dopo l'inizializzazione della mappa.

L'impostazione della lingua influisce sulla lingua in cui vengono visualizzati i controlli dell'UI, i suggerimenti e le note sul copyright. Gli aggiornamenti delle impostazioni internazionali di runtime si riflettono nella visualizzazione della mappa, ma non in altri controlli dell'UI, suggerimenti o altri elementi simili. Influisce anche sulla traduzione di elementi politici, descrittori ed elementi naturali, ad esempio la modifica di "Geneva" in "Genève" o di "lake" in "lac", e cambia la direzione in cui viene eseguito il rendering del testo per gli script da destra a sinistra.

Maps 3D SDK for Android cerca le preferenze di localizzazione nel seguente ordine. Se le preferenze non sono definite nel primo passaggio, continua a cercarle nell'ordine specificato:

  1. Aggiornamenti di runtime: preferenze di lingua e regione passate a setLocale nell'istanza GoogleMap3D utilizzando LocaleOptions.
  2. Inizializzazione della mappa: preferenze di lingua e preferenze locali specificate durante la creazione della mappa, nel file XML del layout su Map3DView utilizzando gli attributi map3d:language e map3d:region oppure a livello di programmazione utilizzando Map3DInitConfig.
  3. Impostazioni del dispositivo: le impostazioni internazionali predefinite del sistema configurate sul dispositivo Android.

L'esempio seguente mostra una mappa in cinese ("zh") e imposta la regione sulla Cina ("CN").

Puoi configurare la lingua e la regione nel file XML del layout utilizzando gli map3d:language e map3d:region attributi su Map3DView:

<com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mapMode="hybrid"
    map3d:language="zh"
    map3d:region="CN" />

Puoi anche aggiornare la lingua e la regione in modo dinamico in fase di runtime creando un' LocaleOptions istanza, impostando i valori con setLanguage e setRegion, e passandola a setLocale nell'istanza GoogleMap3D:

val localeOptions = LocaleOptions().apply {
    language = "zh"
    region = "CN"
}
googleMap3D.setLocale(localeOptions)

Localizzazione della regione

L'impostazione della regione utilizzando l'attributo XML map3d:region, la region proprietà su Map3DInitConfig, o setRegion su LocaleOptions può fornire riquadri mappa diversi o orientare l'applicazione verso risultati più appropriati a livello regionale. Inoltre, l'impostazione del tag della regione garantisce che l'applicazione sia conforme alle leggi locali applicando la localizzazione regionale corretta per il paese o il territorio in cui viene distribuita.