Localiza el mapa

Para personalizar la configuración de idioma y región que se usa en tu mapa, debes cambiar la configuración de idioma predeterminada y el código de región del mapa, lo que puede afectar el comportamiento del mapa según el país o el territorio especificados.

Consulta la cobertura del SDK de Maps 3D para Android en la tabla de cobertura de Maps.

Localización de idiomas

De forma predeterminada, el SDK de Maps 3D para Android usa la configuración de idioma configurada en el dispositivo del usuario para determinar qué traducción del mapa se debe mostrar. Sin embargo, puedes anular este comportamiento predeterminado y establecer un idioma específico cuando inicializas el mapa, o bien actualizar el idioma y la región de forma dinámica después de que se inicializa el mapa.

Configurar el idioma afecta el idioma en el que se muestran los controles de la IU, las sugerencias sobre herramientas y los avisos de derechos de autor. Las actualizaciones de la configuración regional del entorno de ejecución se reflejan en la vista del mapa, pero no en ninguno de los otros controles de la IU, las sugerencias sobre herramientas ni otros elementos similares. También afecta la traducción de las funciones políticas, los descriptores y las funciones naturales, como cambiar "Geneva" a "Genève" o "lake" a "lac", y cambia la dirección en la que se renderiza el texto para las secuencias de comandos de derecha a izquierda.

El SDK de Maps 3D para Android busca las preferencias de localización en el siguiente orden. Si no se definen las preferencias en el primer paso, continúa buscando en el orden especificado:

  1. Actualizaciones del entorno de ejecución: Preferencias de idioma y región que se pasan a setLocale en tu GoogleMap3D instancia con LocaleOptions.
  2. Inicialización del mapa: Preferencias de idioma y región especificadas cuando se crea el mapa, ya sea en el XML de diseño en Map3DView con los atributos map3d:language y map3d:region, o de forma programática con Map3DInitConfig.
  3. Configuración del dispositivo: La configuración regional predeterminada del sistema configurada en el dispositivo Android.

En el siguiente ejemplo, se muestra un mapa en chino ("zh") y se establece la región en China ("CN").

Puedes configurar el idioma y la región en tu archivo en formato XML de diseño con los map3d:language y map3d:region atributos en 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" />

También puedes actualizar el idioma y la región de forma dinámica en el tiempo de ejecución creando una LocaleOptions instancia, estableciendo los valores con setLanguage y setRegion, y pasándola a setLocale en tu instancia de GoogleMap3D:

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

Localización regional

Configurar la región con el map3d:region atributo XML, la region propiedad en Map3DInitConfig, o setRegion en LocaleOptions puede mostrar diferentes mosaicos de mapas o sesgar la aplicación hacia resultados más adecuados para la región. Además, configurar la etiqueta de región garantiza que la aplicación cumpla con las leyes locales aplicando la localización regional correcta para el país o el territorio donde se distribuye la aplicación.