Cómo obtener una clave de API

Selecciona la plataforma: Android iOS JavaScript

Ahora que configuraste la facturación y un proyecto, habilitaste el SDK y instalaste tu administrador de dependencias preferido y otro software, ya puedes crear, agregar y restringir tu clave de API.

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

1. Ve a la página Google Maps Platform > Credenciales.

   Ir a la página Credenciales

2. 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.
3. 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:

• gcloud alpha services api-keys create

Necesitas esta clave de API cuando creas tu proyecto de Xcode, como se describe en Cómo configurar un proyecto de Xcode.

Nota: Puedes utilizar la misma clave de API para tus apps del SDK de Maps para iOS y del SDK de Places para iOS.

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 se restringe una clave de API en la consola de Cloud, las restricciones de aplicaciones anulan todas las APIs habilitadas en las restricciones de API. Si deseas seguir las prácticas recomendadas, crea una clave de API independiente para cada app y cada plataforma en la que dicha app esté disponible.

Para restringir una clave de API, sigue estos pasos:

Consola

1. Ve a la página Google Maps Platform > Credenciales.

   Ir a la página Credenciales

2. Selecciona la clave de API para la que deseas establecer una restricción. Aparecerá la página de propiedades de la clave de API.
3. En Restricciones de clave, establece las siguientes restricciones:
• Restricciones de aplicaciones:
1. Selecciona Apps para iOS.
2. Para aceptar solicitudes de la app para iOS con el identificador de paquete que proporciones, selecciona el identificador de paquete de iOS adecuado de la lista.
• Restricciones de API:
1. Haz clic en Restringir clave.
2. Selecciona SDK de Maps para iOS en el menú desplegable Seleccionar API. Si no ves el SDK de Maps para iOS, deberás habilitarlo.
4. Para finalizar los cambios, haz clic en Guardar.
   

SDK de Cloud

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/keys/KEY_ID" \
    --api-target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

• gcloud alpha services api-keys update
• gcloud alpha services api-keys lookup
• gcloud services api-keys list

Ahora que tienes tu clave de API para el SDK de Maps para iOS, ya puedes comenzar.

¿Qué sigue?

Ahora que tienes una clave de API, crea y configura tu proyecto de Xcode como se describe en Cómo configurar un proyecto de Xcode.