Configuración y demostración

Selecciona la plataforma: Android iOS

En esta página, se describe cómo configurar la biblioteca de utilidades del SDK de Maps para iOS.

Para probar estas utilidades, puedes hacer lo siguiente:

Agrega la Biblioteca de utilidades del SDK de Maps para iOS a un proyecto de Xcode

Sigue estos pasos para agregar la biblioteca de utilidades a tu espacio de trabajo de Xcode:

Usa Swift Package Manager

  1. Si aún no tienes un proyecto de Xcode, créalo y guárdalo en tu máquina local. (Si eres nuevo en el desarrollo para iOS, crea un proyecto nuevo y selecciona la plantilla de app para iOS. En Xcode 11.7 o versiones anteriores, crea una Single View Application).
  2. Agrega el SDK de Maps para iOS como dependencia. Consulta Cómo instalar el SDK para ver las opciones.
  3. En tu proyecto de Xcode, navega a File -> Swift Packages -> Add Package Dependency.
  4. En la ventana que aparece, ingresa la URL del repositorio de la Biblioteca de utilidades del SDK de Maps para iOS https://github.com/googlemaps/google-maps-ios-utils y selecciona Next.
    • En este punto, es posible que se te solicite que te autentiques con tu cuenta de GitHub. Sigue las instrucciones para crear un token de acceso personal de GitHub para continuar con el proceso.
  5. En la siguiente ventana, selecciona la opción de radio Version, selecciona Up to Next Major Version en la lista desplegable y, luego, ingresa la versión más reciente de la Biblioteca de utilidades del SDK de Maps para iOS (por ejemplo, "6.0.0").
  6. Haz clic en el menú desplegable junto a Add to Project, selecciona tu proyecto y, luego, Add Package.

Agrega la clave de API a tu app

Consulta Cómo configurar un proyecto de Xcode para obtener instrucciones para generar una clave de API y agregarla a tu proyecto de Xcode.

Compila y ejecuta el proyecto

Después de agregar la clave de API, compila y ejecuta el proyecto.

Usa una utilidad en tu app

Consulta la documentación de cada utilidad para obtener más información sobre cómo usarla en tu app:

Instala y ejecuta la app de demostración

La biblioteca de utilidades incluye una app de demostración que puedes instalar y, luego, probar cada utilidad.

Para instalar la app de demostración, haz lo siguiente:

Usa archivos de GitHub

  1. Descarga el archivo de muestra de código de GitHub y descomprímelo. De manera alternativa, clona el repositorio en un directorio local: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Abre una ventana de la terminal, navega al directorio en el que expandiste los archivos de muestra y explora el directorio de muestras adecuado para el lenguaje que deseas usar:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

Agrega la clave de API a la app de demostración

En Obtén una clave de API, generas una clave de API para tu app. Ahora, agrega esa clave al proyecto de Xcode para la app de demostración.

Swift

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

  1. Agrega la siguiente instrucción de importación: 
    import GoogleMaps
  2. Edita la siguiente línea para agregar tu clave de API entre las comillas dobles: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

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

  1. Agrega la siguiente instrucción de importación: 
    @import GoogleMaps;
  2. Edita la siguiente línea para agregar tu clave de API entre las comillas dobles: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Cómo compilar y ejecutar la app de demostración

Después de agregar la clave de API, compila y ejecuta el proyecto:

  • Si ejecutas la versión de Swift de la demostración, puedes seleccionar qué utilidad ver en la app.
  • Si ejecutas la versión de Objective-C de la demostración, verás la demostración de la utilidad de agrupamiento de marcadores en clústeres. Luego, puedes editar la versión de Objective-C de la demostración para probar cada utilidad. Consulta la sección Agrega una utilidad a tu app que aparece a continuación para obtener más información.