Modo básico

El SDK de Maps para Android permite publicar una imagen de mapa de bits de un mapa y ofrecer interactividad limitada al usuario. Esto se conoce como un mapa en modo lite.

Muestras de código

El repositorio ApiDemos en GitHub incluye ejemplos que muestran el uso del modo lite:

• LiteDemoActivity - Java: Conceptos básicos para usar un mapa en el modo lite en Java
• LiteDemoActivity - Kotlin: Conceptos básicos para usar un mapa en el modo lite en Kotlin
• LiteListDemoActivity - Java: Cómo mostrar mapas de manera eficiente en ListViews con el modo lite en Java
• LiteListDemoActivity - Kotlin: Cómo mostrar mapas de manera eficiente en ListViews con el modo lite en Kotlin

Descripción general del modo lite

El modo lite muestra una imagen de mapa de bits correspondiente a un mapa de una ubicación determinada y con un nivel de zoom específico. Además, este modo es compatible con todos los tipos de mapa (normal, híbrido, satelital y de terreno), así como con un subconjunto de las funcionalidades proporcionadas por la API completa. Resulta útil cuando deseas proporcionar una serie de mapas en un flujo o un mapa demasiado pequeño como para admitir una interacción significativa.

Los usuarios que vean el mapa no podrán desplazarse lateralmente por él ni aplicarle zoom. Los íconos del mapa les brindan a los usuarios la posibilidad de ver el mapa en la app de Google Maps para dispositivos móviles y de solicitar instrucciones para llegar a un lugar.

Cómo agregar un mapa en el modo lite

El modo lite utiliza las mismas interfaces y clases que la API completa de Google Maps para Android. Puedes configurar un objeto GoogleMap en el modo lite de las siguientes maneras:

• Mediante un atributo XML de un objeto MapView o MapFragment
• Directamente en el objeto GoogleMapOptions

Mediante un atributo XML de un objeto MapView o MapFragment

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

Directamente en el objeto GoogleMapOptions

val options = GoogleMapOptions()
    .liteMode(true)

      

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

Para obtener detalles acerca de cómo configurar el estado inicial del mapa, consulta la guía sobre el objeto de mapa.

Intents para iniciar una vista de mapa o una solicitud de instrucciones sobre cómo llegar

De forma predeterminada, se muestra una barra de herramientas en la esquina inferior derecha del mapa con íconos que proporcionan acceso a una vista de mapa o a una solicitud de instrucciones sobre cómo llegar en la app de Google Maps para dispositivos móviles. Para inhabilitar la barra de herramientas, llama a UiSettings.setMapToolbarEnabled(false). Para obtener más detalles, consulta la documentación sobre la barra de herramientas.

También de forma predeterminada, cuando un usuario presiona el mapa, la API inicia la app de Google Maps para dispositivos móviles. Puedes anular esta función con GoogleMap.setOnMapClickListener() para configurar tu propio objeto de escucha. También puedes inhabilitar los eventos de clic en el mapa si llamas a setClickable() en la vista que contiene el objeto MapView o MapFragment. Para obtener más detalles sobre estas dos técnicas, consulta la documentación sobre eventos.

Eventos de ciclo de vida

Cuando se utiliza la API en el modo completamente interactivo, los usuarios de la clase MapView deben reenviar todos los métodos de ciclo de vida de la actividad a los métodos correspondientes de la clase MapView. Algunos ejemplos de métodos de ciclo de vida son onCreate(), onDestroy(), onResume() y onPause().

Cuando se utiliza la clase MapView en el modo lite, el reenvío de eventos de ciclo de vida es opcional, excepto en las siguientes situaciones:

• Es obligatorio llamar a onCreate(). De lo contrario, no aparecerá ningún mapa.
• Si deseas mostrar el punto de Mi ubicación en el mapa en el modo lite y utilizar la fuente de ubicación predeterminada, deberás llamar a onResume() y onPause(), ya que la fuente de ubicación solo se actualizará entre estas llamadas. Si utilizas tu propia fuente de ubicación, no es necesario llamar a estos dos métodos.

Funciones de API compatibles

En la siguiente tabla, se describe el comportamiento de un mapa en el modo lite para cada área de funcionalidades de la API. Si una app llama a un método que no es compatible en el modo lite, la API registrará un mensaje de advertencia.