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 es la primera vez que realizas desarrollos para iOS, crea un proyecto nuevo y selecciona la opción App para iOS plantilla. En Xcode 11.7 o versiones anteriores, crea una Single View Application).
2. Agrega el SDK de Maps para iOS como dependencia. Consulta Instala el SDK para ver las opciones.
3. En tu proyecto de Xcode, navega a File -> Paquetes de Swift -> Agrega una dependencia de paquete.
4. En la ventana que se muestra, 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 el instrucciones para crear un GitHub token de acceso personal para continuar con el proceso.
5. En la siguiente ventana, elige el botón de selección Version y, luego, 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.

Usar CocoaPods

1. Si aún no tienes un proyecto de Xcode, crea uno ahora y guárdalo en tu máquina local. (Si es la primera vez que realizas desarrollos para iOS, crea una Single Ver aplicación).
2. Si aún no tienes un archivo Pod para tu proyecto, crea uno llamado Podfile en el directorio de tu proyecto. Este archivo define tu las dependencias del proyecto.
3. Edita el archivo Pod de tu proyecto y agrega una dependencia en el Google-Maps-iOS-Utils Pod. Este es un ejemplo que incluye 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.0.0' # x-release-please-version
   end

4. Ejecuta pod install.
5. Cierra Xcode y, luego, abre (con doble clic) el archivo .xcworkspace para iniciar Xcode. A partir de este momento, debes usar el archivo .xcworkspace para abrir el proyecto.

Nota: La utilidad del agrupamiento de marcadores en clústeres depende del quadtree, pero puedes usarlo sin agrupar los marcadores en clústeres. Si quieres solo con la utilidad del quadtree, puedes cambiar pod 'Google-Maps-iOS-Utils' a 'Google-Maps-iOS-Utils/QuadTree' en tu archivo Pod.

Usar archivos de GitHub

1. Descargar el archivo de muestra de código de GitHub y desempaquetar el archivo.
2. Abre una ventana de terminal, navega al directorio donde expandiste los archivos de muestra. desglosa el directorio de ejemplos correspondiente para el lenguaje que quieres 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 y, luego, abre (con doble clic) el archivo .xcworkspace para iniciar Xcode. A partir de este momento, debes usar el archivo .xcworkspace para abrir el proyecto.

Usa CocoaPods v1.6.1.

1. Abre una ventana de terminal e instala la versión 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. Recupera los archivos de Google Maps con CocoaPods:

   pod try Google-Maps-iOS-Utils

   Cuando se solicite, elige Swift o Objective-C. CocoaPods actualiza tus repositorios de especificaciones, Luego, abre la demostración en un proyecto de Xcode temporal llamado SwiftDemoApp.xcodeproj o ObjCDemoApp.xcodeproj.

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