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:
- Instala la biblioteca de utilidades en un proyecto de Xcode existente. Agrega estas utilidades a tu propio proyecto.
- Instala y ejecuta la app de demostración. La aplicación de demostración es un proyecto independiente que contiene todo el código necesario para probar las utilidades.
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
- 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).
- Agrega el SDK de Maps para iOS como dependencia. Consulta Instala el SDK para ver las opciones.
- En tu proyecto de Xcode, navega a File -> Paquetes de Swift -> Agrega una dependencia de paquete.
- 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.
- 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”).
- Haz clic en el menú desplegable junto a Add to Project, selecciona tu proyecto y, luego, Add Package.
Usar CocoaPods
- 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).
- 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. - 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
- Ejecuta
pod install
. - 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:
- Marcador agrupamiento en clústeres
- Quadtree
- Renderización KML
- Renderización de GeoJSON
- Mapa de calor
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
- Descargar el archivo de muestra de código de GitHub y desempaquetar el archivo.
- 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
.
- Para Swift, ejecuta
- Ejecuta el siguiente comando:
pod install
- 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.
- Abre una ventana de terminal e instala la versión 1.6.1:
sudo gem install cocoapods -v1.6.1
- 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
oObjCDemoApp.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:
- Agrega la siguiente sentencia de importación:
import GoogleMaps
- 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:
- Agrega la siguiente sentencia de importación:
@import GoogleMaps;
- 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.