Compartir vía

Obtención de una clave de la API de Google Maps

  • Artículo

Para usar la funcionalidad de Google Maps en Android, debe registrarse para obtener una clave de la API de Maps con Google. Hasta que no lo haga, solo verá una cuadrícula en blanco en lugar de un mapa en sus aplicaciones. Debe obtener una clave de la versión 2 de la API de Google Maps para Android: las claves de la versión 1 de la API de Google Maps para Android no funcionarán.

Para obtener una clave de la versión 2 de la API de Maps, hay que realizar los siguientes pasos:

  1. Recupere la huella digital SHA-1 del almacén de claves que se usa para firmar la aplicación.
  2. Cree un proyecto en la consola de API de Google.
  3. Obtenga la clave de API.

Obtención de la huella digital de la clave de firma

Para solicitar una clave de API de Maps a Google, debe conocer la huella digital SHA-1 del almacén de claves que se usa para firmar la aplicación. Normalmente, esto significa que tendrá que determinar la huella digital SHA-1 para el almacén de claves de depuración y, a continuación, la huella digital SHA-1 del almacén de claves que se usó para firmar la aplicación para su lanzamiento.

De forma predeterminada, el almacén de claves que se utiliza para firmar las versiones de depuración de una aplicación de Xamarin.Android puede encontrarse en la siguiente ubicación:

C:\Usuarios\[NOMBREDEUSUARIO]\AppData\Local\Xamarin\Mono for Android\debug.keystore

La información acerca de un almacén de claves se obtiene ejecutando el comando keytool desde el JDK. La herramienta normalmente se encuentra en el siguiente directorio bin de Java:

C:\Archivos de programa\Android\jdk\microsoft_dist_openjdk_[VERSION]\bin\keytool.exe

Ejecute keytool con el siguiente comando (con las rutas de acceso de archivo que se muestran arriba):

keytool -list -v -keystore [STORE FILENAME] -alias [KEY NAME] -storepass [STORE PASSWORD] -keypass [KEY PASSWORD]

Ejemplo de Debug.keystore

Para la clave de depuración predeterminada (que se crea automáticamente para su depuración), use este comando:

keytool.exe -list -v -keystore "C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Claves de producción

Al implementar una aplicación en Google Play, debe estar firmada con una clave privada. keytool deberá ejecutarse con los detalles de la clave privada y la huella digital SHA-1 resultante utilizada para crear una clave de producción de la API de Google Maps. Recuerde actualizar el archivo AndroidManifest.xml con la clave de la API de Google Maps correcta antes de la implementación.

Salida de keytool

Debería ver algo parecido a la siguiente salida en la ventana de la consola:

Alias name: androiddebugkey
Creation date: Jan 01, 2016
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

En esta guía, usará la huella digital SHA-1 (que aparece después de SHA1).

Crear un proyecto de API

Una vez que haya recuperado la huella digital SHA-1 del almacén de claves de firma, es necesario crear un proyecto en la consola de API de Google (o agregar el servicio de la versión 2 de la API de Google Maps para Android a un proyecto).

  1. En un explorador, navegue hasta consola de Google Developers y vaya al panel de control APIs y Servicios. Luego, haga clic en Selecciona un proyecto. Haga clic en el nombre de un proyecto o cree uno haciendo clic en Nuevo proyecto:

    Google Developer Console CREATE PROJECT button

  2. Si ha creado un proyecto, escriba el nombre del proyecto en el cuadro de diálogo Nuevo proyecto que se muestra. Este cuadro de diálogo creará un identificador de proyecto único basado en el nombre del proyecto. A continuación, haga clic en el botón Crear como se muestra en este ejemplo:

    New project is named XamarinMapsDemo

  3. Después de un minuto aproximadamente, se crea el proyecto y se le redireccionará a la página Panel de control del proyecto. Desde allí, haga clic en HABILITAR APIs Y SERVICIOS:

    Clicking Google Maps Android API in the Library section

  4. En la página Biblioteca de APIs, haga clic en Maps SDK for Android (SDK de Maps para Android). En la página siguiente, haga clic en Habilitar para activar el servicio en este proyecto:

    Clicking the ENABLE button in the Dashboard section

En este punto, se ha creado el proyecto de API y se le ha agregado la versión 2 de la API de Google Maps para Android. Sin embargo, no puede usar esta API en el proyecto hasta que cree las credenciales para ella. En la sección siguiente se explica cómo crear una clave de API y autorizar a una aplicación de Xamarin.Android a usar esta clave.

Obtención de la clave de API

Una vez creado el proyecto de API en la consola de Google Developers, es necesario crear una clave de API de Android. Las aplicaciones Xamarin.Android deben tener una clave de API antes de que se les conceda acceso a la versión 2 de Maps para Android.

  1. En la página Maps SDK for Android (SDK de Maps para Android) que se muestra (después de hacer clic en HABILITAR en el paso anterior), vaya a la pestaña Credenciales y haga clic en el botón Crear credenciales:

    Maps SDK for Android Credentials message

  2. Haga clic en Clave de API:

    Add credentials to your project dialog

  3. Después de hacer clic en este botón, se genera la clave de API. A continuación, es necesario restringir esta clave para que solo la aplicación pueda llamar a las API con esta clave. Haga clic en RESTRINGIR CLAVE:

    Clicking Restrict Key on the Credentials page

  4. Cambie el campo Nombre de Clave de API 1 a un nombre que lo ayude a recordar para qué se usará la clave (en este ejemplo se usa XamarinMapsDemoKey). A continuación, haga clic en el botón de radio Aplicaciones Android:

    Selecting Android apps on the Credentials page

  5. Para agregar la huella digital SHA-1, haga clic en Agregar nombre de paquete y huella digital:

    Clicking Add package name and fingerprint

  6. Escriba el nombre del paquete de la aplicación y el de la huella digital del certificado SHA-1 (obtenida a través de keytool como se explicó anteriormente en esta guía). En el ejemplo siguiente, se escribe el nombre del paquete de XamarinMapsDemo, seguido de la huella digital del certificado SHA-1 obtenida de Debug.keystore:

    Package name entered is com.xamarin.docs.android.map

  7. Tenga en cuenta que, para que el APK tenga acceso a Google Maps, debe incluir los nombres de paquete y las huellas digitales SHA-1 para cada almacén de claves (depuración y lanzamiento) que se use para firmar el APK. Por ejemplo, si usa un equipo para la depuración y otro para generar el APK de versión, debe incluir la huella digital del certificado SHA-1 desde el almacén de claves de depuración del primer equipo y la huella digital del certificado SHA-1 del almacén de claves de versión del segundo equipo. Haga clic en Agregar nombre de paquete y huella digital para agregar otra huella digital y otro nombre del paquete, tal como se muestra en este ejemplo:

    Adding another fingerprint creates another SHA-1 certificate

  8. Haga clic en el botón Guardar para guardar los cambios. A continuación, volverá automáticamente a la lista de claves de API. Si tiene otras claves de API que ha creado anteriormente, también se mostrarán aquí. En este ejemplo, solo se muestra una clave de API (creada en los pasos anteriores):

    XamarinMapsDemoKey is shown in the API keys list

Conexión del proyecto a una cuenta facturable

A partir del 11 de junio de 2018, la clave de API no funcionará si el proyecto no está conectado a una cuenta facturable (aunque el servicio siga siendo gratuito para aplicaciones móviles).

  1. Haga clic en el botón del menú lateral y seleccione la página Facturación:

    Selecting the hamburger menu billing section

  2. Para vincular el proyecto a una cuenta de facturación, haga clic en Enlazar cuenta de facturación y después en CREAR CUENTA DE FACTURACIÓN, en el menú emergente mostrado (si no tiene una cuenta, se le redireccionará a una página para crear una):

    Link project to billing account

Incorporación de la clave al proyecto

Por último, agregue esta clave de API al archivo AndroidManifest.XML de la aplicación Xamarin.Android. En el ejemplo siguiente, YOUR_API_KEY se reemplazará por la clave de API generada en los pasos anteriores:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionName="4.10" package="com.xamarin.docs.android.mapsandlocationdemo"
    android:versionCode="10">
...
  <application android:label="@string/app_name">
    <!-- Put your Google Maps V2 API Key here. -->
    <meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_API_KEY" />
    <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
  </application>
</manifest>