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

Obtener una clave de API

Para usar la Google Maps Android API, debes registrar el proyecto de tu aplicación en la Google API Console y obtener una clave de API de Google que puedes agregar a tu aplicación. Nota: Existen varios tipos de restricciones para las claves de API. Necesitas una clave de API con restricción para Android apps (no una clave con restricciones de navegador).

Guía rápida para obtener una clave

Paso 1: Obtener una clave de API desde la Google API Console

Haz clic en el botón que aparece a continuación, el cual te guiará a lo largo del proceso y activará Google Maps Android API automáticamente.

Obtener una clave

Notas:

  • Para clientes de Google Maps APIs Premium Plan: Cuando veas el menú desplegable de proyectos, debes seleccionar el proyecto que se creó cuando adquiriste el Google Maps APIs Premium Plan. El nombre del proyecto comienza con Google Maps APIs for Business or Google Maps for Work or Google Maps.
  • Si deseas comprar una licencia de Premium Plan, comunícate con el sector de ventas.
  • Si deseas realizar pruebas, puedes crear una clave de API genérica y sin restricciones que funcione en cualquier plataforma. Para asegurar tu clave antes de avanzar a la producción, debes restringir la clave como se describe a continuación.

Paso 2: Agrega la clave de la API a tu aplicación

Sigue los pasos que se indican a continuación para incluir la clave de API en el manifiesto de tu aplicación, que se encuentra en el archivo AndroidManifest.xml.

  1. En AndroidManifest.xml, agrega el siguiente elemento como elemento secundario (o hijo) del elemento <application>; para ello, insértalo antes de la etiqueta de cierre </application>:
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
        

    Cambia tu clave de API por YOUR_API_KEY en el atributo value. Este elemento establece la clave com.google.android.geo.API_KEY en el valor de tu clave de API.

  2. Guarda AndroidManifest.xml y vuelve a compilar tu aplicación.

Nota: Como se mostró anteriormente, com.google.android.geo.API_KEY es el nombre de metadatos recomendado para la clave de API. Una clave con este nombre se puede usar para autenticar en múltiples API basadas en Google Maps en la plataforma Android, incluida la Google Maps Android API. En lo que respecta a compatibilidad con versiones anteriores, la API también admite el nombre com.google.android.maps.v2.API_KEY. Este nombre heredado permite la autenticación en la Android Maps API v2 únicamente. Una aplicación puede especificar solo uno de los nombres de metadatos de la clave de API. Si se especifican ambos, la API retorna una excepción.

Eso es todo. Si pudiste aplicar los pasos anteriores con éxito, habrás terminado. Si experimentaste algún problema, lee las siguientes instrucciones detalladas sobre la API estándar y la Premium Plan.

Guías detalladas para obtener una clave de API

Guía detallada para usuarios de Google Maps Android API estándar

Si el botón no te dirigió al sitio correcto, puedes seguir estos pasos alternativos para obtener una clave de API:

  1. Ingresa a Google API Console.
  2. Crea o selecciona un proyecto.
  3. Haz clic en Continue para habilitar Google Maps Android API.
  4. En la página de Credentials, obtén una clave de API.
    Nota: Si tienes una clave de API con restricciones de Android, puedes usarla.
  5. En el cuadro de diálogo en el que aparece la clave de API, selecciona Restrict Key para agregar una restricción de Android a la clave de API.
  6. En la sección Restrictions, selecciona Android apps, e ingresa el nombre del paquete y la huella digital SHA-1 de tu app. Por ejemplo:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
  7. Consulta más información sobre las restricciones de la clave de API, a continuación.
  8. Haz clic en Save.

Tu nueva clave de API con restricción de Android aparece en la lista de claves de API de tu proyecto. Una clave de API es una cadena de caracteres similar a la siguiente:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Guía detallada para usuarios de la licencia de Google Maps APIs Premium Plan

Si el botón no te dirigió al sitio correcto, puedes seguir estos pasos alternativos para obtener una clave de API:

  1. Ingresa a Google API Console.
  2. En el menú desplegable Project, selecciona el proyecto Google Maps Premium.*
  3. Haz clic en Continue.
  4. En la página de Credentials, obtén una clave de API.
  5. En el cuadro de diálogo en el que aparece la clave de API, selecciona Restrict Key para agregar una restricción de Android a la clave de API.
  6. En la sección Restrictions, selecciona Android apps, e ingresa el nombre del paquete y la huella digital SHA-1 de tu app. Por ejemplo:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
    Consulta más información sobre las restricciones de la clave de API, a continuación.
  7. Haz clic en Save.

Tu nueva clave de API con restricción de Android aparece en la lista de claves de API de tu proyecto. Una clave de API es una cadena de caracteres similar a la siguiente:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Información adicional sobre la Google API Console

También puedes buscar una clave existente en Google API Console.

Para obtener más información sobre el uso de la Google API Console, consulta Ayuda de la API Console.

Información adicional sobre las restricciones de la clave de API

Las Google Maps API están disponibles para apps de Android o iOS y navegadores web, y a través de servicios web HTTP. Las API de cualquier plataforma pueden usar una clave de API genérica (sin restricciones). Si lo deseas, puedes agregar una restricción. En las apps de Android, la clave se restringe al nombre del paquete y a la huella digital SHA-1 de tu app. Las claves con restricciones solo funcionan en plataformas que admitan dicho tipo de restricción.

Dónde obtener la huella digital SHA-1 de tu app

La restricción de clave de Android API se basa en una versión corta del certificado digital de tu app, que se conoce como huella digital SHA-1.

Obtener la información del certificado desde Android Studio

Si sigues las instrucciones de la guía de introducción a Google Maps Android API, Android Studio creará un archivo google_maps_api.xml útil que incluya las credenciales de tu app.

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.

Obtener la información del certificado por ti mismo

Si no sigues las instrucciones de la guía de introducción cuando crees tu app, deberás obtener tú mismo la huella digital SHA-1 para tu certificado. Primero, verifica que estés usando el certificado correcto. Puedes tener dos certificados:

  • Un certificado de depuración: Android SDK Tools genera este certificado automáticamente cuando realizas una versión de depuración. Usa este certificado solo con aplicaciones que estés probando. No intentes publicar una aplicación firmada con un certificado de depuración. El certificado de depuración se describe con más detalle en Firma en modo de depuración de la documentación para desarrolladores de Android.
  • Un certificado de lanzamiento: Android SDK Tools genera este certificado cuando realizas una versión de lanzamiento. También puedes generar este certificado mediante el programa keytool. Usa este certificado cuando estés listo para lanzar tu aplicación al mundo.

Sigue los pasos que se indican a continuación para mostrar la huella digital SHA-1 de un certificado mediante el programa keytool con el parámetro -v. Para obtener más información sobre Keytool, consulta la documentación de Oracle.

Certificado de depuración

Visualización de la huella digital del certificado de depuración

  1. Busca tu archivo de depuración de depósito de claves. El nombre del archivo es debug.keystore y se crea la primera vez que compilas tu proyecto. De manera predeterminada, se guarda en el mismo directorio que tus archivos del Android Virtual Device (AVD):

    • macOS y Linux: ~/.android/
    • Windows Vista y Windows 7: C:\Users\your_user_name\.android\
  2. Indica la huella digital SHA-1:

    • En el caso de Linux u OS X, abre una ventana de la terminal y escribe lo siguiente:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • Para Windows Vista y Windows 7, ejecuta lo siguiente:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Deberías ver un resultado similar a esto:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
Certificado de lanzamiento

Visualización de la huella digital del certificado de lanzamiento

  1. Busca tu archivo de depósito de claves para certificado de lanzamiento. No existe una ubicación ni un nombre predeterminados para el archivo de depósito de claves de lanzamiento. Si no especificas uno al momento de compilar tu aplicación para el lanzamiento, la compilación dejará tu archivo .apk sin firmar y deberás firmarlo antes de poder publicarlo. Para el certificado de lanzamiento, también necesitas el alias del certificado y las contraseñas del depósito de claves y del certificado. Puedes indicar los alias de todas las claves en un archivo de depósito de claves al ingresar lo siguiente:

    keytool -list -keystore your_keystore_name

    Reemplaza your_keystore_name por la ruta de acceso completamente calificada y el nombre del archivo de depósito de claves, incluida la extensión .keystore. Se te pedirá que ingreses la contraseña del depósito de claves. A continuación, keytool muestra todos los alias del archivo de depósito de claves.

  2. En una ventana de terminal o de comandos, escribe lo siguiente:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Reemplaza your_keystore_name por la ruta de acceso completamente calificada y el nombre del archivo de depósito de claves, incluida la extensión .keystore. Reemplaza your_alias_name por el alias que le asignaste al certificado cuando lo creaste.

Deberías ver un resultado similar a esto:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

La línea que comienza con SHA1 incluye la huella digital SHA-1 del certificado. La huella digital es una secuencia de 20 números hexadecimales de dos dígitos separados por dos puntos.

Consulta la guía de Android sobre la firma de tus aplicaciones para obtener más información sobre los certificados digitales.

Enviar comentarios sobre...

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