Localiser la carte

Vous pouvez personnaliser les paramètres de langue et de région utilisés dans votre carte en modifiant les paramètres de langue par défaut et le code de région de la carte, ce qui peut avoir une incidence sur le comportement de la carte en fonction du pays ou du territoire spécifié.

Consultez la couverture du SDK Maps 3D pour Android dans le tableau de couverture Maps.

Localisation linguistique

Par défaut, le SDK Maps 3D pour Android utilise les paramètres de langue configurés sur l'appareil de l'utilisateur pour déterminer quelle traduction de la carte afficher. Toutefois, vous pouvez remplacer ce comportement par défaut et définir une langue spécifique lors de l'initialisation de la carte, ou modifier la langue et la région de manière dynamique après l'initialisation de la carte.

La définition de la langue a une incidence sur la langue dans laquelle les commandes de l'interface utilisateur, les info-bulles et les mentions de copyright sont affichées. Les mises à jour des paramètres régionaux au moment de l'exécution sont reflétées dans la vue de la carte, mais pas dans les autres commandes d'interface utilisateur, info-bulles ou autres éléments de ce type. Cela a également une incidence sur la traduction des caractéristiques politiques, des descripteurs et des caractéristiques naturelles (par exemple, "Geneva" devient "Genève" ou "lake" devient "lac") et modifie le sens de rendu du texte pour les scripts de droite à gauche.

Le SDK Maps 3D pour Android recherche les préférences de localisation dans l'ordre suivant. Si aucune préférence n'est définie à la première étape, la recherche se poursuit dans l'ordre spécifié :

  1. Mises à jour au moment de l'exécution : préférences de langue et préférences régionales transmises à setLocale sur votre GoogleMap3D instance à l'aide de LocaleOptions.
  2. Initialisation de la carte : préférences de langue et préférences régionales spécifiées lors de la création de la carte, soit dans le fichier XML de mise en page sur Map3DView à l'aide des attributs map3d:language et map3d:region, soit par programmation à l'aide de Map3DInitConfig.
  3. Paramètres de l'appareil : paramètres régionaux par défaut du système configurés sur l'appareil Android

L'exemple suivant affiche une carte en chinois ("zh") et définit la région sur Chine ("CN").

Vous pouvez configurer la langue et la région dans votre fichier XML de mise en page à l'aide des map3d:language et map3d:region attributs sur 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" />

Vous pouvez également modifier la langue et la région de manière dynamique au moment de l'exécution en créant une LocaleOptions instance, en définissant les valeurs avec setLanguage et setRegion, puis en la transmettant à setLocale sur votre instance GoogleMap3D :

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

Localisation régionale

La définition de la région à l'aide de l'attribut XML map3d:region, de la propriété region sur Map3DInitConfig, ou setRegion sur LocaleOptions peut diffuser différentes tuiles de carte ou orienter l'application vers des résultats plus adaptés à la région. De plus, la définition de la balise de région garantit que l'application respecte les lois locales en appliquant la localisation régionale appropriée pour le pays ou le territoire où l'application est distribuée.