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 una dependencia. Consulta Instala el SDK para conocer las opciones.
  3. En tu proyecto de Xcode, navega a File -> Swift Packages -> Add Package Dependency.
  4. En la ventana que se presenta, 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 Siguiente.
    • 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 y continuar con el proceso.
  5. En la siguiente ventana, selecciona la opción de radio Version, elige 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 Agregar al proyecto, selecciona tu proyecto y, luego, Agregar paquete.

Usar CocoaPods

  1. Si aún no tienes un proyecto de Xcode, créalo y guárdalo en tu máquina local. (Si es la primera vez que desarrollas para iOS, crea una Single View Application).
  2. Si aún no tienes un archivo pod para tu proyecto, crea un archivo llamado Podfile en el directorio de tu proyecto. Este archivo define las dependencias de tu proyecto.
  3. Edita el archivo pod de tu proyecto y agrega una dependencia en el pod Google-Maps-iOS-Utils. A continuación, te mostramos un ejemplo en el que se incluyen las dependencias que necesitas para el SDK de Maps para iOS y la biblioteca de utilidades: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
end
  4. Ejecuta pod install.
  5. Cierra Xcode. Luego, haz doble clic en el archivo .xcworkspace de tu proyecto para abrirlo y que se inicie Xcode. A partir de este momento, debes usar el archivo .xcworkspace para abrir el proyecto.

Nota: La utilidad de agrupamiento de marcadores depende del cuádruple árbol, pero puedes usar el cuádruple árbol sin el agrupamiento de marcadores. Si solo quieres la utilidad de quadtree, puedes cambiar pod 'Google-Maps-iOS-Utils' a 'Google-Maps-iOS-Utils/QuadTree' en tu archivo pod.

Agrega la clave de API a tu app

Consulta Configura un proyecto Xcode para obtener instrucciones sobre cómo generar una clave de API y agregarla a tu proyecto 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.

Instala la app de demostración:

Cómo usar archivos de GitHub

  1. Descarga el archivo de muestra de código desde GitHub y descomprímelo.
  2. Abre una ventana de terminal, navega al directorio en el que expandiste los archivos de muestra y desplázate hasta el directorio de muestras correspondiente al idioma que deseas usar:
    • Para Swift, ejecuta cd google-maps-ios-utils-master/samples/SwiftDemoApp.
    • Para Objective-C, ejecuta cd google-maps-ios-utils-master/samples/ObjCDemoApp.
  3. Ejecuta el siguiente comando:
    pod install
  4. Cierra Xcode. Luego, haz doble clic en el archivo .xcworkspace de tu proyecto para abrirlo y que se inicie Xcode. A partir de este momento, debes usar el archivo .xcworkspace para abrir el proyecto.

Agrega la clave de API a la app de demo

En Obtén una clave de API, generas una clave de API para tu app. Ahora, agrega esa clave al proyecto de Xcode de 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 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 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 Swift de la demostración, puedes seleccionar qué utilidad quieres 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 Cómo agregar una utilidad a tu app a continuación para obtener más información.