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:

Instala CocoaPods (opcional)

La biblioteca de utilidades está disponible como un Pod de CocoaPods llamado Google-Maps-iOS-Utils. CocoaPods es un administrador de dependencias de código abierto para proyectos de Swift y Objective-C de Cocoa.

Si todavía no tienes la herramienta CocoaPods, instálala en macOS ejecutando el siguiente comando desde la terminal:

sudo gem install cocoapods

Para obtener más detalles, consulta la guía de introducción de CocoaPods.

Instala y ejecuta la app de demostración

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

Instala la app de demostración usando uno de estos dos métodos:

Usa archivos de GitHub

  1. Descarga el archivo de muestra de código desde GitHub y descomprime el archivo.
  2. Abre una ventana de terminal, navega al directorio en el que expandiste los archivos de muestra y desglosa el directorio de muestras correspondiente al lenguaje que deseas usar:
    • Si usas 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 el archivo .xcworkspace de tu proyecto (haz doble clic en él) 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 y, luego, abre la demostración en un proyecto de Xcode temporal llamado SwiftDemoApp.xcodeproj o ObjCDemoApp.xcodeproj.

Cómo agregar la clave de API a la app de demostración

En Obtener una clave de API, debes generar 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 declaració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 declaració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 estás ejecutando la versión 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. A continuación, puedes editar la versión de Objective-C de la demostración para probar cada utilidad. Para obtener más información, consulta la sección Cómo agregar una utilidad a tu app a continuación.

Instalar la biblioteca de utilidades como proyecto de Xcode

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

Mediante CocoaPods

  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 una aplicación de vista única).
  2. Si aún no tienes un archivo de Pods 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, se muestra 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, '13.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '7.4.0'
      pod 'Google-Maps-iOS-Utils', '4.2.2'
    end
  4. Ejecuta pod install.
  5. Cierra Xcode y, luego, abre el archivo .xcworkspace de tu proyecto (haz doble clic en él) 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 usar el quadtree sin agrupar los marcadores en clústeres. Si solo deseas la utilidad del quadtree, puedes cambiar pod 'Google-Maps-iOS-Utils' por 'Google-Maps-iOS-Utils/QuadTree' en el archivo del Pod.

Usar Cartago

  1. Instala Cartago. Existen varios métodos, por lo que te recomendamos consultar el archivo README de Carthage para conocer los pasos exactos.
  2. 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).
  3. Crea un archivo llamado Cartfile en el directorio de tu proyecto. Este archivo define las dependencias de tu proyecto.
  4. Edita el archivo Cartfile y agrega la dependencia de la Biblioteca de utilidades del SDK de Maps para iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Guarda el Cartfile.
  6. En una ventana de terminal, ve al directorio que contiene Cartfile:
    cd <path-to-project>
  7. Ejecuta el comando update:
    carthage update --platform iOS

    De esta manera, se instalarán las APIs especificadas en Cartfile, junto con las dependencias que puedan tener.
  8. En Finder, en el directorio de tu proyecto, ve a los archivos de framework descargados en Carthage/Build/iOS.
  9. Agrega los frameworks del SDK de Maps para iOS a tu proyecto. Para ello, arrastra los siguientes paquetes a tu proyecto. (Cuando se te solicite, selecciona Copiar elementos si es necesario; utiliza la misma versión que la anterior).
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
  10. Haz clic derecho sobre GoogleMaps.framework en tu proyecto y selecciona Show In Finder.
  11. Arrastra el archivo Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle de la carpeta Resources al proyecto. Cuando se te solicite, asegúrate de que la opción Copy items into destination group's folder no esté seleccionada.
  12. Selecciona tu proyecto en el navegador de proyectos y elige el destino para la aplicación.
  13. Abre la pestaña Build Phases del destino de tu aplicación y, en Link Binary with Libraries, agrega los siguientes frameworks:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework
  14. Elige tu proyecto, en lugar de un destino específico, y abre la pestaña Build Settings. En la sección Other Linker Flags, agrega -ObjC. Si esta configuración no es visible, cambia el filtro en la barra Build Settings deBasic a All.

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 disponibles.
  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 https://github.com/googlemaps/google-maps-ios-utils de la biblioteca de utilidades del SDK de Maps para iOS y selecciona Siguiente.
    • En este punto, es posible que se te solicite autenticar con tu cuenta de GitHub. Sigue las instrucciones para crear un token de acceso personal de GitHub a fin de continuar con el proceso.
  5. En la siguiente ventana, selecciona la opción de selección Versión, elige Exacta en la lista desplegable, ingresa la versión más reciente de la Biblioteca de utilidades del SDK de Maps para iOS (p.ej., "3.4.0") y selecciona Siguiente.

Agrega la clave de API a tu app

Consulta Cómo configurar un proyecto de Xcode para obtener instrucciones sobre cómo 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.

Cómo agregar una utilidad a tu app

Consulta la documentación de cada utilidad para obtener más información sobre su uso en tu aplicación: