Localiza el mapa

Puedes personalizar la configuración de idioma y región que se usa en tu mapa. Para ello, cambia 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 territorio especificado.

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 en 3D para Android usa la configuración de idioma establecida 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 inicialices el mapa, o bien actualizar el idioma y la región de forma dinámica después de que se inicialice el mapa.

Establecer el idioma afecta el idioma en el que se muestran los controles de la IU, las descripciones emergentes y los avisos sobre derechos de autor. Las actualizaciones de la configuración regional del entorno de ejecución se reflejan en la vista de mapa, pero no en ninguno de los otros controles de la IU, información sobre herramientas ni otros elementos similares. También afecta la traducción de los componentes políticos, los descriptores y los componentes naturales (por ejemplo, cambia "Ginebra" por "Genève" o "lago" por "lac") y cambia la dirección en la que se renderiza el texto para las escrituras de derecha a izquierda.

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

  1. Actualizaciones del entorno de ejecución: Las preferencias de idioma y región se pasan a setLocale en tu instancia de GoogleMap3D con LocaleOptions.
  2. Inicialización del mapa: Son las preferencias de idioma y región que se especifican 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 manera programática con Map3DInitConfig.
  3. Configuración del dispositivo: Es la configuración regional predeterminada del sistema que se estableció 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 de diseño XML con los atributos map3d:language y map3d:region 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 durante el tiempo de ejecución. Para ello, crea una instancia de LocaleOptions, establece los valores con setLanguage y setRegion, y pásala a setLocale en tu instancia de GoogleMap3D:

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

Localización regional

Si configuras la región con el atributo XML map3d:region, la propiedad region en Map3DInitConfig o setRegion en LocaleOptions, se pueden mostrar diferentes mosaicos de mapas o se puede personalizar la aplicación para que muestre 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, ya que aplica la localización regional correcta para el país o territorio en el que se distribuye la aplicación.