Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps Android API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps Android API
  3. Crear claves correspondientes
Continuar

Modo básico

La Google Maps Android API puede mostrar una imagen estática como un mapa en el “modo básico”.

Ejemplos de código

En el repositorio de ApiDemos de GitHub se incluyen ejemplos en los cuales se muestra el uso del modo básico:

Información general sobre el modo básico

Un mapa en el modo básico es una imagen de mapa de bits en una ubicación y con un nivel de zoom especificados. El modo básico admite todos los tipos de mapas (normal, híbrido, satélite y tierra) y un subconjunto de la funcionalidad proporcionada por toda la API. Resulta útil cuando deseas suministrar varios mapas en un flujo o un mapa demasiado pequeño para admitir una interacción significativa.

Los usuarios que visualizan el mapa no pueden aplicarle zoom ni desplazamiento. Los iconos del mapa permiten que los usuarios visualicen el mapa en la aplicación móvil de Google Maps y que soliciten indicaciones.

Cómo agregar un mapa en el “modo básico”

El modo básico usa las mismas clases e interfaces que la Google Maps Android API completa. Puedes configurar un GoogleMap en el modo básico de las siguientes maneras:

  • como un atributo XML para MapView o MapFragment;
  • o en el objeto GoogleMapOptions.

como un atributo XML para 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"/>

En el objeto GoogleMapOptions

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

Para obtener información detallada sobre la configuración del estado inicial del mapa, consulta la guía del objeto map.

Intenciones para iniciar una vista de mapa o una solicitud de indicaciones

De manera predeterminada, en una barra de herramientas de la parte inferior derecha del mapa se muestran iconos que proporcionan acceso a una vista de mapa o solicitud de indicaciones en la aplicación móvil de Google Maps. Puedes deshabilitar la barra de herramientas llamando a UiSettings.setMapToolbarEnabled(false). Para obtener información más detallada, consulta la documentación sobre la barra de herramientas.

De manera predeterminada, también, cuando un usuario toca el mapa la API inicia la aplicación móvil de Google Maps. Puedes invalidar esto usando GoogleMap.setOnMapClickListener() para configurar tu propio receptor. También puedes deshabilitar eventos de clic del mapa llamando a setClickable() en la vista que contenga MapView o MapFragment. Para obtener información sobre estas dos técnicas, consulta la documentación sobre eventos.

Eventos de ciclo de vida

Al usar la API en el modo totalmente interactivo, los usuarios de la clase MapView deben enviar todos los métodos de ciclo de vida de actividad a los métodos correspondientes de la clase MapView. Entre los ejemplos de los métodos de ciclo de vida se incluyen onCreate(), onDestroy(), onResume() y onPause().

Al usar la clase MapView en el modo básico, el envío de eventos de ciclo de vida es opcional, salvo en las siguientes situaciones:

  • Llamar a onCreate() es obligatorio. De lo contrario, no aparecerán mapas.
  • Si deseas que se muestre el punto “My Location” en tu mapa de modo básico y que se use 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 usas tu propia fuente de ubicación, no es necesario que llames a estos dos métodos.

Características de la API compatibles

En la tabla siguiente, se describe el comportamiento de un mapa en el modo básico para cada área de la funcionalidad de la API. Si una aplicación llama a un método no admitido en el modo básico, la API generará un mensaje de advertencia.

Functionalidad
Tipos de mapas
¿Compatible?
Los siguientes tipos de mapas se encuentran disponibles a través GoogleMapOptions.mapType() y GoogleMap.setMapType(): MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN, MAP_TYPE_HYBRID, MAP_TYPE_NONE
Polilíneas, polígonos y círculos
¿Compatible?
La funcionalidad de modo básico para formas se adecua a toda la API.
Proyección
¿Compatible?
La funcionalidad de modo básico para Projection se adecua a toda la API.
My Location
¿Compatible?
La funcionalidad de modo básico para la capa “My Location” se adecua a toda la API.
Relleno de mapas
¿Compatible?
La compatibilidad con el modo básico para relleno de mapas se adecua a toda la API.
Ventanas de información
¿Compatible?
Si configuras el title() de un marcador, la ventana de información predeterminada aparecerá cuando el usuario toque el marcador. Puedes hacer que se muestre la ventana de información de manera programática llamando a showInfoWindow() en el marcador. También puedes crear ventanas de información personalizadas a través de la interfaz de InfoWindowAdapter.
Estilos personalizados
¿Compatible?
La Google Maps Android API admite estilos personalizados.
Marcadores
¿Compatible? Parcialmente
Puedes agregar un marcador y responder a un evento de clic. También puedes agregar iconos de marcadores personalizados. No es posible hacer que un marcador pueda arrastrarse. Los marcadores de un mapa en el modo básico son planos y no es posible rotarlos.
Posición, zoom y animación de la cámara
¿Compatible? Parcialmente

Puedes configurar el objetivo y el zoom de la cámara, pero no es posible hacer lo mismo con la inclinación y el rumbo. El nivel de zoom se redondea hacia el valor entero más cercano en el modo básico. Si llamas a GoogleMap.moveCamera() accederás a otra imagen estática de mapa. Para obtener más información sobre la configuración y manipulación de la cámara, consulta Cómo cambiar la vista.

Si llamas a GoogleMap.animateCamera() no habrá animación del movimiento de la cámara. La vista de la cámara se moverá en forma instantánea hasta la nueva posición.

Eventos de mapas
¿Compatible? Parcialmente

El modo básico admite GoogleMap.setOnMapClickListener() y GoogleMap.setOnMapLongClickListener().

Para deshabilitar eventos de clic de un mapa en el modo básico, puedes llamar a setClickable() en la vista que contenga MapView o MapFragment. Esto resulta útil, por ejemplo, al mostrar uno o varios mapas en una vista de lista, en la cual deseas que el evento de clic invoque una acción no relacionada con el mapa.

Para obtener información detallada, consulta la documentación sobre eventos.

Mapas de interiores y edificios
¿Compatible? No
En el modo básico se muestran los mismos mosaicos que en la Google Static Maps API. Esto significa que el plano de pisos interiores aparecerá si se integra al mosaico predeterminado. Si esto no sucede, no aparecerá. A su vez, no es posible cambiar el nivel que se muestra ni manipular un seleccionador de niveles.
Capa de tráfico
¿Compatible? No
GoogleMap.setTrafficEnabled() no es compatible en el modo básico.
Superposiciones de suelo
¿Compatible? No
GoogleMap.addGroundOverlay() no es compatible en el modo básico.
Superposiciones de mosaicos
¿Compatible? No
GoogleMap.addTileOverlay() no es compatible en el modo básico.
Gestos
¿Compatible? No
El modo básico no admite gestos. Habilitar y deshabilitar gestos no producirá efectos.
Street View
¿Compatible? No
Street View no es compatible en el modo básico.

Enviar comentarios sobre...

Google Maps Android API
Google Maps Android API
Si necesitas ayuda, visita nuestra página de asistencia.