Una vez que habilites la facturación y crees una clave de API, podrás configurar el proyecto de Xcode que usarás para desarrollar tu app.
Las notas de la versión están disponibles para cada versión.
Paso 1: Instala el software requerido
Para compilar un proyecto con el SDK de Places para iOS, necesitas lo siguiente:
- Xcode versión 26.0 o posterior
Paso 2: Crea el proyecto de Xcode e instala el SDK de Places para iOS
Swift Package Manager
El SDK de Places para iOS se puede instalar a través de Swift Package Manager. Para agregar el SDK, asegúrate de haber quitado las dependencias existentes del SDK de Places para iOS.
Para agregar el SDK a un proyecto nuevo o existente, sigue estos pasos:
-
Abre tu
projectoworkspacede Xcode y, luego, 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 "Add Package".
-
Para instalar un
versionespecífico, configura el campo Regla de dependencia en una de las opciones basadas en la versión. Para los proyectos nuevos, te recomendamos que especifiques la versión más reciente y uses la opción "Exact Version". Cuando termines, haz clic en "Agregar paquete". - En la ventana Choose Package Products, verifica que se agreguen
GooglePlaces,GooglePlacesSwifto ambos al destino principal designado. Cuando termines, haz clic en Agregar paquete.Si actualizas Google Places Swift desde la URL de GitHub obsoleta
Importante: La URL de GitHub para acceder a Google Places Swift cambió a partir de la versión 0.3.0. Si actualizas una versión de GooglePlacesSwift a la que se accedió a través de la URL anterior,
https://github.com/googlemaps/ios-places-swift-sdk, quítala de la sección de dependencias de paquetes de Xcode. - Para verificar la instalación, navega al panel General de tu destino. En Frameworks, Libraries, and Embedded Content, deberías ver los paquetes instalados. También puedes ver la sección Package Dependencies de Project Navigator para verificar el paquete y su versión.
Para actualizar el package de un proyecto existente, sigue estos pasos:
-
En Xcode, ve a File > Packages > Update To Latest Package Versions.
Si actualizas Google Places Swift desde la URL de GitHub obsoleta
Importante: La URL de GitHub para acceder a Google Places Swift cambió a partir de la versión 0.3.0. Si actualizas una versión de GooglePlacesSwift a la que se accedió a través de la URL anterior,
https://github.com/googlemaps/ios-places-swift-sdk, quítala de la sección de dependencias de paquetes de Xcode. - Para verificar la instalación, ve a la sección Package Dependencies de Project Navigator y verifica el paquete y su versión.
Para quitar el SDK de Places para iOS existente que se instaló de forma manual, sigue estos pasos:
-
En los ajustes de configuración de tu proyecto de Xcode, busca Frameworks, Libraries,
and Embedded Content. Usa el signo menos (-) para quitar los siguientes frameworks:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
En el directorio de nivel superior de tu proyecto de Xcode, quita el paquete
GooglePlaces.
Instalación manual
En esta guía, se muestra cómo agregar manualmente los XCFrameworks que contienen el SDK de Places para iOS y el SDK de Places para Swift para iOS a tu proyecto y establecer la configuración de compilación en Xcode. Un XCFramework es un paquete binario que puedes usar en varias plataformas, incluidas las máquinas que usan Apple Silicon. Puedes agregar el SDK de Places para iOS, el SDK de Places Swift para iOS o ambos.
- Descarga los siguientes archivos de recursos y objetos binarios del SDK:
- Si vas a instalar el SDK de Places para iOS con Swift, instala los siguientes archivos:
- Extrae los archivos para acceder al XCFramework y a los recursos.
- Ejecuta Xcode y abre un proyecto existente o crea uno nuevo. Si eres principiante en el desarrollo para iOS, crea un proyecto nuevo y selecciona la plantilla de app para iOS.
- Quita cualquier paquete de Maps de las versiones anteriores de tu proyecto.
-
Abre la pestaña General. Arrastra el siguiente XCFramework a tu proyecto
en Frameworks, Libraries, and Embedded Content. Asegúrate de seleccionar Do Not Embed:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Copia el archivo
GooglePlaces.bundlede GooglePlacesResources que descargaste en el directorio de nivel superior de tu proyecto de Xcode. Asegúrate de seleccionar Copiar elementos en la carpeta del grupo de destino cuando se te solicite.
Si estás instalando el SDK de Places para Swift, copia el archivoGooglePlacesSwift.bundlede GooglePlacesSwiftResources que descargaste en el directorio de nivel superior de tu proyecto de Xcode. Asegúrate de seleccionar Copiar elementos en la carpeta del grupo de destino cuando se te solicite. - Selecciona tu proyecto en el navegador de proyectos y elige el destino de tu aplicación.
-
Abre la pestaña Build Phases. En Link Binary with
Libraries, agrega los siguientes frameworks y bibliotecas:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Elige tu proyecto, en lugar de un destino específico, y abre la pestaña Build Settings. En la sección Linking - General -> Other Linker Flags, agrega
-ObjCa "Debug" y "Release". Si no puedes ver estos parámetros de configuración, cambia el filtro de la barra Build Settings de Basic a All.
Paso 3: Agrega la clave de API a tu app
En los siguientes ejemplos, reemplaza YOUR_API_KEY por tu clave de API.
Agrega tu clave de API a AppDelegate.swift de la siguiente manera:
- Agrega la siguiente instrucción de importación:
import GooglePlacesSwift
- Agrega lo siguiente a tu método
application(_:didFinishLaunchingWithOptions:), reemplazando YOUR_API_KEY por tu clave de API:PlacesClient.provideAPIKey("YOUR_API_KEY")
Swift
Agrega tu clave de API a AppDelegate.swift de la siguiente manera:
- Agrega la siguiente instrucción de importación:
import GooglePlaces
- Agrega lo siguiente a tu método
application(_:didFinishLaunchingWithOptions:)y reemplaza YOUR_API_KEY por tu clave de API:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Agrega tu clave de API a AppDelegate.m de la siguiente manera:
- Agrega la siguiente instrucción de importación:
@import GooglePlaces;
- Agrega lo siguiente a tu método
application:didFinishLaunchingWithOptions:, reemplazando YOUR_API_KEY por tu clave de API:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Paso 4 (opcional): Inspecciona el archivo de manifiesto de privacidad de Apple
Apple exige que se proporcionen detalles de privacidad de las apps en la App Store. Visita la página de detalles de privacidad de la App Store de Apple para obtener actualizaciones y más información.
El archivo de manifiesto de privacidad de Apple se incluye en el paquete de recursos del SDK. Para verificar que se haya incluido el archivo de manifiesto de privacidad y para inspeccionar su contenido, crea un archivo de tu app y genera un informe de privacidad a partir de él.
Próximos pasos
- Comienza a escribir código. Un punto de partida recomendado es implementar una app de inicio que obtenga el lugar actual del usuario.
- Una vez que tu proyecto esté configurado, podrás explorar las apps de ejemplo.
- Usa la Verificación de aplicaciones para proteger tu clave de API.