SDK de Maps para iOS: Cómo obtener una clave de API

Nota: El plan premium de Google Maps Platform ya no está disponible para registros o clientes nuevos.

A fin de utilizar el SDK de Maps para iOS, debes tener una clave de API. La clave de API es un identificador único que se utiliza para autenticar solicitudes asociadas con tu proyecto con fines de uso y facturación.

Cómo crear claves de API

Debes tener, al menos, una clave de API asociada a tu proyecto.

Para obtener una clave de API, haz lo siguiente:

  1. Ve a Google Cloud Platform Console.
  2. Haz clic en el menú desplegable de proyectos y selecciona el que se creó cuando compraste el plan premium. El nombre del proyecto comienza con API de Google Maps for Business, Google Maps for Work o Google Maps.
  3. Nota: Para tener acceso completo a las funciones de su plan, los clientes premium deben usar el proyecto asociado con su cuenta premium. Cuando compraste tu licencia, recibiste el nombre de tu elemento premium en el siguiente formato: gme-[company] & proj-[number] ([type]). Para asegurarte de utilizar el proyecto correcto, accede a la consola como propietario mediante console.cloud.google.com/project/number (reemplaza number por tu número de proyecto). Puedes encontrar el propietario del proyecto en tu carta de bienvenida.

  4. Haz clic en el botón de menú  y selecciona API y servicios > Credenciales.
  5. 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 (una string encriptada).
  6. Haz clic en Cerrar.
    La nueva clave de API aparecerá en la página Credenciales debajo de Claves de API.

Cómo agregar la clave de API a tu app

En los siguientes ejemplos, reemplaza YOUR_API_KEY por tu clave de API.

Swift

Agrega tu clave de API a AppDelegate.swift de la siguiente manera:

  1. Agrega la siguiente sentencia de importación:
    import GoogleMaps
  2. Agrega lo siguiente a tu método application(_:didFinishLaunchingWithOptions:). Para ello, reemplaza YOUR_API_KEY por tu clave de API:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. Si también usas la API de Places, vuelve a agregar tu clave como se muestra a continuación:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Agrega tu clave de API a AppDelegate.m de la siguiente manera:

  1. Agrega la siguiente sentencia de importación:
    @import GoogleMaps;
  2. Agrega lo siguiente a tu método application:didFinishLaunchingWithOptions:. Para ello, reemplaza YOUR_API_KEY por tu clave de API:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. Si también usas la API de Places, vuelve a agregar tu clave como se muestra a continuación:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Cómo restringir las claves de API

Restringir las claves de API agrega seguridad a tu aplicación, ya que garantiza que solo se realicen solicitudes autorizadas con tu clave de API. Te recomendamos enfáticamente que sigas las instrucciones si deseas configurar restricciones para tus claves de API. Para obtener más información, consulta Prácticas recomendadas sobre las claves de API.

Para restringir una clave de API, sigue estos pasos:

  1. En GCP Console, en la página del selector de proyectos, selecciona o crea un proyecto de Google Cloud en el que deseas agregar una clave de API.

    Ir a la página del selector de proyectos

  2. Ve a la página API y servicios > Credenciales.

    Ir a la página Credenciales

  3. Selecciona la clave de API para la que deseas establecer una restricción. Aparecerá la página de propiedades de la clave de API.
  4. En Restricciones de clave, establece las siguientes restricciones:
    • Restricciones de aplicaciones:
      1. Selecciona Apps para iOS.
      2. A fin de aceptar solicitudes de la App para iOS con el identificador de paquete que proporcionas, selecciona el identificador del 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 el SDK de Maps para iOS no aparece en la lista, debes habilitarlo).
  5. Para finalizar los cambios, haz clic en Guardar.