Configuración y demostración

Selecciona la plataforma: Android iOS

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

Para probar estas utilidades, tienes las siguientes opciones:

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 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 Versión y, luego, Hasta la próxima versión principal 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, créalo 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.

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 de Xcode.

Compila y ejecuta el proyecto

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

Cómo usar una utilidad en tu app

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

Cómo instalar y ejecutar 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 mediante uno de estos dos métodos:

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.

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

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

Swift

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

  1. Agrega la siguiente sentencia 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 sentencia 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 aplicación.
  • Si tienes la versión Objective-C de la demostración, verás la demostración del de agrupamiento de marcadores en clústeres. Luego, puedes editar la versión 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.