Las apps de demostración de SDK proporcionadas con el SDK de Places para iOS demuestran una serie de funciones, como el autocompletado y las fotos de lugares. Además, puedes encontrar fragmentos de código en cada página de esta guía para desarrolladores.
Prueba las demostraciones de SDK usando CocoaPods
El SDK de Places para iOS está disponible como un Pod de CocoaPods. CocoaPods es un administrador de dependencias de código abierto para proyectos de Swift y Objective-C de Cocoa.
El SDK de Places para iOS proporciona un conjunto de apps de demostración del SDK que puedes instalar y ejecutar con el comando pod try
:
- GooglePlaces muestra el autocompletado de lugares y las fotos de lugares.
Sigue estos pasos para instalar CocoaPods y probar el SDK de Places para iOS:
- Si todavía no tienes la herramienta CocoaPods, instálala en macOS ejecutando el siguiente comando desde la terminal. Para obtener más detalles, consulta la guía de introducción de CocoaPods.
sudo gem install cocoapods
- Obtén los archivos de muestra mediante uno de estos dos métodos:
Usa archivos de GitHub
- Descarga el archivo de muestra de código desde GitHub y descomprime el archivo.
- Abre una ventana de terminal, navega al directorio en el que expandiste los archivos de muestra y desglosa el directorio de GooglePlaces:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective‑C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- Ejecuta el siguiente comando:
pod install
open GooglePlacesDemos.xcworkspace
Usar 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 Places con CocoaPods:
pod try GooglePlaces
CocoaPods actualiza tus repositorios de especificaciones y abre las demostraciones del SDK en un proyecto de Xcode temporal,
GooglePlacesDemos.xcworkspace
.
- Habilita el SDK de Places para iOS en tu proyecto de la consola de Google Cloud.
- Si aún no tienes una clave de API, sigue las instructions para configurar un proyecto en la consola de Cloud y obtener una. Cuando configuras la clave en la consola de Cloud, puedes especificar el identificador de paquete de tu app para asegurarte de que solo tu app pueda usar la clave. El identificador de paquete predeterminado de la app de muestra del SDK es
com.example.GooglePlacesDemos
. - Edita el archivo
SDKDemoAPIKey
y pega tu clave de API en la constante correspondiente. Por ejemplo:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective‑C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Si Xcode te solicita desbloquear el archivo
SDKDemoAPIKey
para editarlo, selecciona Desbloquear. - Si está presente, quita la siguiente línea porque se usa para registrar el problema:
Swift
#error (Regístrate para obtener la clave de API e insértala aquí. Luego, borra esta línea").
Objective‑C
#error Register your API key and insert here, then delete this line.
- Genera y ejecuta el proyecto de nuevo.
- Si la compilación falla o la app falla con un error sobre tu clave de API cuando la ejecutas por primera vez, asegúrate de haber proporcionado las claves requeridas en el archivo
SDKDemoAPIKey
. - Si estás ejecutando las demostraciones de GooglePlaces, en la ventana del simulador de iOS se mostrará una lista de demostraciones de Places.
- Si se te solicita permitir que GooglePlacesDemos acceda a tu ubicación, selecciona Allow.
- El ejemplo que elijas quedará listo para ejecutarse.
Usa fragmentos de código de la guía para desarrolladores
En cada página de la guía para desarrolladores, se incluyen fragmentos de código que ilustran una función determinada de la API. Por ejemplo, consulta las guías sobre autocompletado, cómo obtener el lugar actual, fotos y otras páginas de esta guía.