Suscripción y claves de API

En esta guía, se indican los pasos que debes seguir para poder comenzar a trabajar con Google Places API for Android.

Información general

Para usar la Google Places API for Android, debes registrar el proyecto de tu app en la Google API Console y obtener una clave de API de Google que puedes agregar a tu app. Nota: Existen varios tipos de restricciones para las claves de API. Necesitas una clave de API con restricción de Android.

Todas las aplicaciones de Android están firmadas con un certificado digital del cual tienes la clave privada. Consulta la guía de Android sobre la firma de tus aplicaciones para obtener más información sobre los certificados digitales.

Las claves de la Android API están vinculadas a pares de paquetes y certificados específicos. Solo necesitas una clave para cada certificado, independientemente de la cantidad de usuarios que usen la aplicación.

Para obtener una clave para tu aplicación, se deben completar varios pasos. Estos pasos se indican a continuación y se describen en detalle en las secciones siguientes.

  1. Obtén información sobre el certificado de tu aplicación.
  2. Registrar un proyecto en Google API Console y agregar Google Places API for Android como servicio para el proyecto.
  3. Solicitar una clave.
  4. Agregar la clave a tu aplicación mediante la incorporación de un elemento en el manifiesto de tu aplicación.

Buscar información sobre el certificado de tu aplicación

La clave de API se basa en una forma corta del certificado digital de tu aplicación, que se conoce como huella digital SHA-1. Para mostrar la huella digital SHA-1 para tu certificado, primero asegúrate de estar usando el certificado correcto. Puedes tener dos certificados:

  • Un certificado de depuración: SDK Tools de Android 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: SDK Tools de Android 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 Dispositivo virtual de Android (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

En la línea que comienza con SHA1, se 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.

Obtener una clave de API a través de la Google API Console

Para comenzar a usar Google Places API for Android, haz clic en el botón que aparece a continuación, que te guiará por todo el proceso de activación de Google Places API for Android y obtención de una clave de API.

Obtén una clave

También puedes seguir estos pasos 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 la Google Places API for Android.
  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.places-example
  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

El aprovisionamiento completo de la clave puede tardar hasta 5 minutos. Si la clave no funciona inmediatamente, haz un nuevo intento en 5 minutos.


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.

Ahora que cuentas con una clave de la API, puedes agregarla al manifiesto de tu aplicación, tal como se describe en la guía de primeros pasos.

Enviar comentarios sobre…