Configura el SDK de Places para Android

En este documento, se describen los pasos necesarios para comenzar a usar el SDK de Places para Android.

Requisitos previos

Este procedimiento te guiará para configurar una cuenta de Google Cloud y un proyecto de Google Cloud con la facturación habilitada. También debes conocer cómo se te cobra por usar el SDK de Places para Android.

  1. Revisa la facturación y el costo de uso en Uso y facturación del SDK de Places para Android.

  2. Verifica que tengas una Cuenta de Google Cloud.

    Accede a la consola de Google Cloud

  3. Verifica que tengas un proyecto de Google Cloud con la facturación habilitada.

    Ir a la página Facturación
    1. Selecciona tu proyecto para abrir la página Facturación.

    2. En la página Facturación, haz lo siguiente:

      • Si la facturación ya está habilitada para el proyecto seleccionado y solo tienes una cuenta de facturación, se abrirá la página Facturación.
      • Si tienes varias cuentas de facturación, selecciona Ir a la cuenta de facturación vinculada para ver los detalles de la cuenta de facturación asociada con el proyecto.
      • Si existe una cuenta de facturación, pero no está asociada al proyecto, se te solicitará que vincules una cuenta de facturación con el proyecto.
      • Si no existe una cuenta de facturación o quieres crear una nueva, selecciona Administrar cuentas de facturación para crear una nueva. Para obtener más información, consulta Crea una nueva cuenta de Facturación de Cloud de servicio automático.

Habilita el SDK

Antes de poder usar el SDK de Places para Android, debes usar la consola de Google Cloud o el comando gcloud para habilitarlo en tu proyecto de Google Cloud.

El SDK de Places para Android depende de la API de Places (nueva). Para habilitar la API de Places (nueva), sigue estos pasos:

Console

  1. Abre la página del producto en la consola de Google Cloud:

    Habilita la API de Places (nueva)

  2. Haz clic en el botón Habilitar.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "places.googleapis.com"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

Configura la clave de API

Los productos de Google Maps Platform están protegidos contra un uso no autorizado porque requieren que las llamadas a la API incluyan una clave de API.

Obtén una clave de API para usarla con la API de Places (nueva)

Una clave de API es una cadena alfanumérica única que asocia tu cuenta de Facturación de Cloud y tu proyecto de Google Cloud con la solicitud que realiza tu aplicación a una API o un SDK de Google Maps Platform. Para crear una clave nueva o agregar una API o un SDK a una clave existente, sigue estas instrucciones.

Console

  1. Ve a la página Google Maps Platform > Claves y credenciales.

    Ir a la página Claves y credenciales

  2. Si se solicita, selecciona tu proyecto.

  3. Realiza una de las siguientes acciones:

    • Crea una clave nueva:

      1. Haz clic en Crear credenciales > Clave de API.
      2. En el panel Crear clave de API, abre la lista Elige las restricciones de API.
      3. Borra las APIs que no necesite esta clave y asegúrate de que la API de Places (nueva) permanezca seleccionada.
      4. Haz clic en Crear. En el panel, se mostrará tu nueva clave de API.

    • Usar una clave existente:

      1. Haz clic en el nombre de la clave.
      2. En la lista Selecciona las restricciones de API, elige API de Places (nueva).
      3. Haz clic en Guardar.

    Seleccionar una API aquí no la habilita. Asegúrate de que la API de Places (nueva) esté habilitada en su página de la biblioteca de APIs.

  4. Para ver la cadena de clave más adelante, ve a la página Claves y credenciales y haz clic en Mostrar clave para la clave.

Si la consola se ve diferente de estos pasos, consulta Crea una clave de API y Agrega restricciones de API en la documentación de Google Cloud.

gcloud

Reemplaza PROJECT_ID por el ID del proyecto en los siguientes comandos.

  • Crea una clave nueva: Ejecuta el siguiente comando y reemplaza DISPLAY_NAME por un nombre para la clave. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=places.googleapis.com

    Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

  • Usa una clave existente: Ejecuta el siguiente comando y reemplaza KEY_ID por el ID de la clave. La marca --append conserva las APIs que la clave ya permite. Sin él, el comando las reemplaza.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=places.googleapis.com

    Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

    El ID de clave no es la cadena de clave ni el nombre visible. Para encontrarlo, ejecuta gcloud services api-keys list --project="PROJECT_ID". El ID es la última parte del campo name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Para ver la cadena de la clave, ejecuta gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Aplica restricciones de claves de API

Google recomienda que restrinjas las claves de API limitando su uso solo a las APIs y las apps que las necesitan. La restricción de las claves de API agrega seguridad a tu aplicación, ya que la protege de solicitudes no autorizadas. Las claves de API admiten dos tipos de restricciones:

  • Las restricciones de API especifican a qué SDKs y APIs se puede llamar con la clave de API. La consola y gcloud CLI requieren al menos una restricción de API cuando creas una clave.
  • Las restricciones de aplicaciones especifican qué sitios web, direcciones IP o apps pueden usar una clave de API.

Para obtener más información sobre cómo aplicar restricciones, consulta Restringe tus claves de API.

¿Qué sigue?

Ahora que habilitaste el SDK de Places para Android y configuraste una clave de API, consulta Cómo configurar un proyecto de Android Studio para obtener más información sobre cómo configurar Xcode y pasar la clave de API a tu app.