La app de demostración del SDK de Places para iOS en GitHub, que se proporciona con el SDK de Places para iOS, muestra varias funciones, como Place Autocomplete y Place Photos. Además, puedes encontrar fragmentos de código en cada página de esta guía para desarrolladores. Puedes importar y compilar la app, agregar tu clave de API, ver una demostración y utilizar el código de muestra proporcionado como punto de partida de tu app.
Cuando ejecutes la app de ejemplo, verás una lista de muestras disponibles que puedes probar en tu propio dispositivo. Selecciona una de las opciones.
Ejecuta la app de ejemplo completa de forma local
La app de ejemplo del SDK de Places para iOS está disponible como un archivo de descarga en GitHub. Sigue estos pasos para instalar y probar la app de ejemplo del SDK de Places para iOS.
- Descarga el archivo de muestra de código desde GitHub y descomprímelo. Como alternativa, clona el repositorio en un directorio local:
git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
Abre una ventana de terminal, navega al directorio en el que expandiste los archivos de muestra y, luego, explora el directorio de la versión que deseas usar:
SwiftUI
cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeprojSwift
cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeprojObjective-C
cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- En el proyecto de Xcode, ve a File > Add Package Dependencies. Ingresa https://github.com/googlemaps/ios-places-sdk como la URL, presiona Intro para extraer el paquete y haz clic en Agregar paquete.
- Habilita el SDK de Places para iOS y el SDK de Maps para iOS para tu proyecto de consola de Google Cloud.
- Obtén una clave de API de tu proyecto con la API de Places o la API de Places (nueva) habilitadas.
- Agrega tu clave de API a la app siguiendo las instrucciones correspondientes que se indican a continuación.
SwiftUI
Crea un archivo de configuración local llamado
GooglePlacesDemos.xcconfigpara tu clave de API en el mismo directorio que el archivoInfo.plistde la aplicación de demostración (GooglePlacesDemos/GooglePlacesDemos).Agrega dos líneas a tu archivo de configuración para definir tus claves de API:
PLACES_API_KEY = YOUR_PLACES_API_KEYyMAPS_API_KEY = YOUR_MAPS_API_KEY.Sustituye
YOUR_PLACES_API_KEYyYOUR_MAPS_API_KEYpor las claves de API de los pasos anteriores.Consulta Formato del archivo de configuración (xcconfig) para obtener ayuda sobre cómo crear un archivo de configuración local.
Swift
Edita el archivo
SDKDemoAPIKeyy pega tu clave de API en la constante adecuada. Por ejemplo:let placesAPIKey = "YOUR_API_KEY"
Si está presente, quita la siguiente línea:
#error (Register for API Key and insert here. Then delete this line.)
Si Xcode te solicita que desbloquees el archivo
SDKDemoAPIKeypara editarlo, elige Unlock.Objective-C
Edita el archivo
SDKDemoAPIKeyy pega tu clave de API en la constante adecuada. Por ejemplo:static NSString *const kAPIKey = @"YOUR_API_KEY";
Si está presente, quita la siguiente línea:
#error (Register for API Key and insert here. Then delete this line.)Si Xcode te solicita que desbloquees el archivo
SDKDemoAPIKeypara editarlo, elige Unlock. - Compila la app.
- Si la compilación falla o la app se bloquea con un error sobre tu clave de API cuando la ejecutas por primera vez, asegúrate de haber proporcionado las claves requeridas en las instrucciones anteriores.
- Si ejecutas la app de ejemplo, la ventana del simulador de iOS mostrará una lista de demostraciones de Places.
- Si se te solicita que permitas que la app de demostración acceda a tu ubicación, elige Permitir.
- El ejemplo que elijas quedará listo para ejecutarse.