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

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: Descarga Android Studio

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

Paso 2: Instala el SDK de Google Play Services

Agrega el paquete de Google Play Services a Android Studio.

Paso 3: Crea 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 app, 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 forma que necesitas para tu app. 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. (Ten en cuenta que tu actividad puede tener un nombre diferente, pero será el que fijaste durante la configuració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: Obtén 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 de API con restricción para Android apps. La clave es gratuita. Puedes usarla con aquellas de tus aplicaciones que llamen a la Google Maps Android API y admitan un número ilimitado de usuarios.

Elige uno de los siguientes métodos para obtener tu clave de API en Android Studio:

  • Un método rápido y simple: 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 el navegador. El vínculo te permite acceder a la Google API Console y proporciona la información necesaria sobre esta 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 Google API Console o selecciona un proyecto existente.
    3. Crea una clave de API con restricción de Android para tu proyecto.
    4. Copia la clave de API obtenida, 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 más lento: usa la credencial proporcionada 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 API Console en tu navegador.
    3. Usa las credenciales copiadas para agregar tu app a una clave de API existente o para crear una clave de API nueva.
  • 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.

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 {

    private GoogleMap mMap;

    @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 googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        mMap.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: Conecta 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 Android Emulator para ejecutar tu aplicación. Usa el Administrador del Android Virtual Device (AVD) para configurar uno o más dispositivos virtuales que podrás usar con el Android Emulator cuando crees y ejecutes tu aplicación. Cuando elijas tu emulador, asegúrate de usar Android 4.2.2 o versiones posteriores y ten cuidado de seleccionar una imagen que incluya las Google API. De lo contrario, la aplicación no tendrá las API de tiempo de ejecución para la ejecución. También toma nota de las instrucciones de configuración de la aceleración de una máquina virtual, que debes usar con un AVD de destino x86 según lo descrito en las instrucciones. Esto mejorará tu experiencia con el emulador.

Paso 7: Crea y ejecuta tu app

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
¿Necesitas ayuda? Visita nuestra página de asistencia.