Antes de comenzar
Para comenzar a usar el SDK de Places para Android, debes habilitarlo y tener un proyecto con una cuenta de facturación. Para obtener más información, consulta Configuración en la consola de Cloud.
Cómo crear claves de API
La clave de API es un identificador único que se utiliza para autenticar solicitudes asociadas a tu proyecto con fines de uso y facturación. Debes tener, al menos, una clave de API asociada a tu proyecto.
Para crear una clave de API, sigue estos pasos:
Consola
-
Ve a la página Google Maps Platform > Credenciales.
-
En la página Credenciales, haz clic en Crear credenciales > Clave de API.
El diálogo Se creó la clave de API mostrará la clave de API que acabas de crear. -
Haz clic en Cerrar.
La nueva clave de API aparecerá en la página Credenciales debajo de Claves de API.
(Recuerda restringir la clave de API antes de utilizarla en producción).
SDK de Cloud
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:
Cómo restringir las claves de API
Google recomienda que restrinjas las claves de API limitando su uso solo a aquellas APIs que sean necesarias para tu aplicación. La restricción de las claves de API agrega seguridad a tu aplicación, ya que la protege de solicitudes no autorizadas. Para obtener más información, consulta Prácticas recomendadas sobre la seguridad de la API.
Cuando restringes tu clave de API, debes proporcionar la huella digital del certificado SHA-1 de la clave que se usó para firmar la aplicación. Existen dos tipos de certificados:
- Certificado de depuración: Usa este tipo de certificado solo con apps que estés probando y con otros códigos que no sean de producción. No intentes publicar una app firmada con un certificado de depuración. Las herramientas del SDK de Android generan este certificado automáticamente cuando ejecutas una compilación de depuración.
- Certificado de lanzamiento: Usa este certificado cuando estés listo para lanzar tu app en una tienda de aplicaciones. Las herramientas del SDK de Android generan este certificado cuando ejecutas una compilación de lanzamiento.
Para obtener más información sobre las firmas y los certificados de aplicaciones para Android, consulta la guía Firma tu app.
Si necesitas instrucciones para encontrar tu huella digital del certificado de firma, consulta las siguientes referencias:
- Si usas la firma de apps de Play, consulta Cómo trabajar con proveedores de APIs.
- Si administras tu propia clave de firma, consulta Cómo autofirmar tu aplicación o las instrucciones para tu entorno de compilación.
Para restringir una clave de API, sigue estos pasos:
Consola
-
Ve a la página Google Maps Platform > Credenciales.
- Selecciona la clave de API para la que deseas establecer una restricción. Aparecerá la página de propiedades de la clave de API.
- En Restricciones de clave, establece las siguientes restricciones:
- Restricciones de aplicaciones:
- Selecciona Apps de Android.
- Haz clic en + Agregar nombre del paquete y huella digital.
- Ingresa el nombre del paquete y la huella digital del certificado SHA-1. Por ejemplo:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- Restricciones de API:
- Haz clic en Restringir clave.
- Selecciona API de Places o API de Places (nueva) en el menú desplegable Seleccionar API, pero no ambas. Si la API de Places no aparece en la lista, debes habilitarla.
- Para finalizar los cambios, haz clic en Guardar.
SDK de Cloud
SDK de Places para Android (nuevo)
Enumera las claves existentes.
gcloud services api-keys list --project="PROJECT"
Borra las restricciones que existen sobre la clave existente.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Establece restricciones nuevas sobre la clave existente.
gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=places.googleapis.com --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:
SDK de Places para Android
Enumera las claves existentes.
gcloud services api-keys list --project="PROJECT"
Borra las restricciones que existen sobre la clave existente.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Establece restricciones nuevas sobre la clave existente.
gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=places-backend.googleapis.com --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:
Próximos pasos
Ahora que tienes una clave de API, crea y configura un proyecto tal como se describe en Configura un proyecto de Android Studio.