Dostosowywanie mapy do lokalizacji

Ustawienia języka i regionu używane na mapie możesz dostosować, zmieniając domyślne ustawienia języka i kod regionu mapy. Może to wpłynąć na działanie mapy w zależności od określonego kraju lub terytorium.

Informacje o zasięgu pakietu SDK Map 3D na Androida znajdziesz w tabeli zasięgu Map.

Lokalizacja języka

Domyślnie pakiet SDK Map 3D na Androida używa ustawień języka skonfigurowanych na urządzeniu użytkownika, aby określić, którą wersję językową mapy wyświetlić. Możesz jednak zastąpić to działanie domyślne i ustawić konkretny język podczas inicjowania mapy lub dynamicznie zaktualizować język i region po zainicjowaniu mapy.

Ustawienie języka wpływa na język, w którym wyświetlane są elementy sterujące interfejsu, etykietki i powiadomienia o prawach autorskich. Aktualizacje ustawień regionalnych w czasie działania aplikacji są odzwierciedlane w widoku mapy, ale nie w żadnych innych elementach sterujących interfejsu, etykietkach ani innych tego typu elementach. Wpływa to również na tłumaczenie elementów politycznych, opisów i elementów naturalnych – np. zmiana „Geneva” na „Genève” lub „lake” na „lac” – oraz zmienia kierunek renderowania tekstu w przypadku skryptów pisanych od prawej do lewej.

Pakiet SDK Map 3D na Androida szuka preferencji lokalizacji w tej kolejności: Jeśli preferencje nie są zdefiniowane w pierwszym kroku, pakiet SDK kontynuuje wyszukiwanie w określonej kolejności:

  1. Aktualizacje w czasie działania aplikacji: preferencje języka i regionu przekazywane do setLocale w instancji GoogleMap3D za pomocą LocaleOptions.
  2. Inicjowanie mapy: preferencje języka i regionu określone podczas tworzenia mapy, w pliku XML układu w Map3DView za pomocą atrybutów map3d:language i map3d:region lub programowo za pomocą Map3DInitConfig.
  3. Ustawienia urządzenia: ustawienie domyślne systemu regionalne skonfigurowane na urządzeniu z Androidem.

Poniższy przykład wyświetla mapę w języku chińskim ("zh") i ustawia region na Chiny ("CN").

Język i region możesz skonfigurować w pliku XML układu za pomocą atrybutów map3d:language i map3d:region w 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" />

Możesz też dynamicznie aktualizować język i region w czasie działania aplikacji, tworząc instancję LocaleOptions , ustawiając wartości za pomocą setLanguage i setRegion, oraz przekazując ją do setLocale w instancji GoogleMap3D:

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

Lokalizacja regionu

Ustawienie regionu za pomocą atrybutu XML map3d:region, właściwości region w Map3DInitConfig, lub setRegion w LocaleOptions może spowodować wyświetlenie różnych kafelków mapy lub ukierunkowanie aplikacji na bardziej odpowiednie wyniki regionalne. Ustawienie tagu regionu zapewnia też, że aplikacja jest zgodna z lokalnymi przepisami, ponieważ stosuje odpowiednią lokalizację regionalną dla kraju lub terytorium, w którym jest rozpowszechniana.