Configuración y demostración

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.

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.

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 = @"";