Primeros pasos

Esta guía sirve como inicio rápido para agregar un mapa a una aplicación de Android. Android Studio es el entorno de desarrollo recomendado para crear una aplicación con la Google Maps Android API.

Paso 1: Descargar Android Studio

Sigue las guías para descargar e instalar Android Studio.

Paso 2: Instalar el SDK de Google Play Services:

Agrega el paquete de Google Play Services a Android Studio.

Paso 3: Crear un proyecto de Google Maps

Sigue estos pasos para crear un nuevo proyecto de aplicación con una actividad de mapa:

  1. Inicia Android Studio.
  2. Crea un proyecto nuevo de la siguiente manera:

    • Si ves el cuadro de diálogo con la leyenda Welcome to Android Studio, selecciona Start a new Android Studio project. Esta opción se encuentra disponible en “Quick Start”, a la derecha del cuadro de diálogo.
    • De lo contrario, haz clic en File en la barra de menú de Android Studio, luego en New y finalmente en New Project.
  3. Escribe el nombre de tu aplicación, el dominio de tu empresa y la ubicación del proyecto, según se solicite. Luego, haz clic en Next.

  4. Selecciona los factores de formulario que necesitas para tu aplicación. Si no estás seguro de lo que necesitas, selecciona Phone and Tablet. Luego, haz clic en Next.
  5. Selecciona Google Maps Activity, en el cuadro de diálogo “Add an activity to Mobile”. Luego, haz clic en Next.
  6. Escribe el nombre de la actividad, el nombre del diseño y el título según se solicite. Los valores predeterminados servirán. Luego, haz clic en Finish.

Android Studio inicia Gradle y crea tu proyecto. Esto puede llevar unos segundos. Para obtener más información sobre la creación de un proyecto en Android Studio, consulta la documentación sobre Android Studio.

Cuando finalice la compilación, Android Studio abrirá los archivos google_maps_api.xml y MapsActivity.java en el editor. (Los nombres de los archivos dependen de los valores de configuración que introdujiste durante la cnofiguración). Antes de intentar ejecutar la aplicación, observa que el archivo google_maps_api.xml contiene instrucciones para la obtención de una clave de Google Maps API. En la sección siguiente se describe en mayor profundidad el método para obtener la clave de API.

Paso 4: Obtener una clave de Google Maps API

Tu aplicación necesita una clave de API para acceder a los servidores de Google Maps. El tipo de clave que necesitas es una clave para aplicaciones de Android. La clave es gratuita. Puedes usarla con cualquiera de tus aplicaciones en las que se llame a la Google Maps Android API y admite un número ilimitado de usuarios.

Selecciona uno de los siguientes métodos para obtener tu clave de API:

  • El método rápido y sencillo: usa el vínculo proporcionado en el archivo google_maps_api.xml que creó Android Studio:

    1. Copia el vínculo proporcionado en el archivo google_maps_api.xml y pégalo en tu navegador. El vínculo te permite acceder a la Google Developers Console y proporciona información a través de parámetros de dirección URL, lo cual reduce la intervención manual por tu parte.
    2. Sigue las instrucciones para crear un nuevo proyecto en la consola o selecciona un proyecto existente.
    3. Crea una clave de la Android API para tu proyecto de la consola.
    4. Copia la clave de API resultante, regresa a Android Studio y pega la clave de API en el elemento <string> del archivo google_maps_api.xml.
  • Un método un poco menos rápido: usa las credenciales proporcionadas en el archivo google_maps_api.xml que creó Android Studio:

    1. Copia las credenciales proporcionadas en el archivo google_maps_api.xml.
    2. Accede a la Google Developers Console en tu navegador.
    3. Usa las credenciales copiadas para agregar tu aplicación a una claves de API existente o crear una nueva. Para obtener información detallada, consulta observa el proceso completo.
  • Todo el proceso de obtención de una clave de API: si ninguna de las opciones anteriores funciona en tu caso, realiza el proceso completo.

Nota: Si usas Google Maps Mobile SDK for Work, de manera adicional debes habilitar Google Maps Mobile SDK for Work para tu proyecto de API en la Google Developers Console.

Paso 5: Hello Map: Echa un vistazo al código

Examina el código proporcionado por la plantilla. En particular, observa los siguientes archivos en tu proyecto de Android Studio.

El archivo de diseño XML

De manera predeterminada, el archivo XML que define el diseño de la aplicación se encuentra en res/layout/activity_maps.xml. Contiene el siguiente código:

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"
    tools:context=".MapsActivity"
    android:name="com.google.android.gms.maps.SupportMapFragment" />

El archivo Java de actividad de mapas

De manera predeterminada, el archivo Java que define la actividad de mapas lleva el nombre MapsActivity.java. Debe contener el siguiente código después del nombre de tu paquete:

import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap map) {
        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        map.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        map.moveCamera(CameraUpdateFactory.newLatLng(sydney));
    }
}

Si archivo de actividad de mapas no contiene el código siguiente, reemplaza el contenido del archivo por el código anterior después del nombre de tu paquete.

Paso 6: Conectar un dispositivo Android

La manera más simple de ver tu aplicación en funcionamiento es conectar un dispositivo Android a tu computadora. Sigue las instrucciones a fin de habilitar opciones para el desarrollador en tu dispositivo Android, y configurar tu aplicación y sistema de modo que detecte el dispositivo.

También puedes usar el emulador de Android para ejecutar tu aplicación. Usa el Administrador del Dispositivo virtual de Android (AVD) para configurar uno o más dispositivos virtuales que podrás usar con el emulador de Android cuando crees y ejecutes tu aplicación. Necesitas una imagen de emulador con la plataforma de API de Google basada en Android 4.2.2 o una versión posterior. Toma nota de las instrucciones de configuración de la aceleración de una máquina virtual, que deberías usar con un AVD de destino x86 según lo descrito en las instrucciones. Esto mejorará tu experiencia con el emulador.

Paso 7: Crear y ejecutar tu aplicación

En Android Studio, haz clic en la opción de menú Run (o el icono del botón de reproducción) para ejecutar tu aplicación.

Cuando se indique que selecciones un dispositivo, elige una de las siguientes opciones:

  • Selecciona el dispositivo Android conectado a tu computadora.
  • Como alternativa, selecciona el botón de radio Launch emulator y elige el dispositivo virtual que configuraste previamente.

Haz clic en OK. Android Studio invocará a Gradle para crear tu aplicación y luego mostrará los resultados en el dispositivo o el emulador. La aplicación podría tardar uno minutes para abrirse.

Podrás ver un mapa con un marcador posicionado sobre Sídney, Australia. Si no vez un mapa, confirma que hayas completado todos los pasos descritos en esta página. En particular, verifica que se haya agregado una clave de API según lo descrito antes.

Próximos pasos

Probablemente desees ver ejemplos de código.

Puedes obtener más información sobre los objetos de mapas en la guía del desarrollador.

Enviar comentarios sobre...

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