Guía de inicio rápido de Geospatial para iOS

En esta guía de inicio rápido de la API de ARCore Geospatial, se muestra cómo ejecutar una app de muestra en Xcode que demuestra la API de Geospatial.

Si quieres obtener una guía para desarrollar tu propia app con la API de Geospatial, consulta la Guía para desarrolladores de Geospatial para iOS.

Consulta la Introducción a la API de ARCore Geospatial para obtener más información sobre la API de Geospatial.

Si es la primera vez que desarrollas con ARCore, consulta Cómo comenzar.

Requisitos previos

  • Xcode versión 13.0 o posterior
  • Cocoapods 1.4.0 o una versión posterior si usas Cocoapods
  • Un dispositivo Apple compatible con ARKit que ejecute iOS 12.0 o versiones posteriores (se requiere un objetivo de implementación de iOS 12.0 o versiones posteriores)

Configura la app de muestra

El proyecto GeospatialExample incluido con el SDK de ARCore para iOS describe el código que llama a la API de Geospatial.

  1. Clona o descarga el SDK de ARCore para iOS desde GitHub para obtener el código de ejemplo de la app.

  2. Abre una ventana de Terminal o Finder y navega a la carpeta en la que clonaste o descargaste el SDK.

  3. Navega a la carpeta arcore-ios-sdk-master/Examples.

  4. Abre la carpeta Examples, selecciona la carpeta GeospatialExample y haz clic en Open.

Configura un proyecto de Google Cloud

Antes de usar el sistema de posicionamiento visual (VPS) en tu app, primero debes habilitar la API de ARCore en un proyecto de Google Cloud nuevo o existente. Aunque la API de Geospatial funciona con la autorización sin clave y con la de clave de API, en esta guía de inicio rápido, usa el método de clave de API.

Configura la autorización

Para realizar llamadas a la API de Geospatial al VPS, la app de ejemplo necesita autorización y puede usar una clave de API sin restricciones. Si usas una clave de API restringida, también debes proporcionar un ID de paquete para asociarlo con la clave de API.

  1. En XCode, en la app de ejemplo GeospatialExample, abre el archivo ViewController.m y busca your-api-key.

  2. Agrega tu clave de API a GARSession: pega la clave de API que copiaste de un paso anterior sobre el texto your-api-key (deja las comillas), como se muestra a continuación:

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

Configura el SDK de ARCore

La app GeospatialExample se envía con un Podfile preconfigurado con las versiones del SDK de ARCore y de iOS que necesitas. Para instalar estas dependencias, abre una ventana de Terminal y ejecuta pod install desde la carpeta en la que existe el proyecto de Xcode.

Esto generará un archivo .xcworkspace que usarás más adelante para compilar y ejecutar la app.

Cómo compilar y ejecutar la app de muestra

  1. En Xcode, selecciona el archivo de lugar de trabajo GeospatialExample y haz clic en Firma y capacidades.

  2. Marca la casilla Administrar la firma automáticamente.

  3. En el campo Equipo, ingresa un nombre para el equipo.

    Puedes usar el identificador de paquete predeterminado para ejecutar la app desde Xcode, pero debes cambiarlo si usas GeospatialExample como stub para tu propia app en producción.

  4. Conecta tu dispositivo para ejecutar la app de ejemplo.

  5. Compila y ejecuta la app GeospatialExample desde el archivo .xcworkspace para iniciarla en tu dispositivo.

    Para evitar errores de compilación, asegúrate de compilar desde el archivo .xcworkspace y no desde el archivo .xcodeproj.

Deberías poder ver una vista de cámara, junto con información de depuración que describe la transformación geoespacial actual de tu dispositivo. A medida que escaneas el entorno que te rodea, ten en cuenta que los valores de confianza de la precisión de posicionamiento pueden cambiar a medida que te mueves, si te encuentras en un área compatible con la localización de VPS.

Cuando ARCore tenga confianza en la ubicación y el rumbo de tu dispositivo, puedes colocar un ancla en tu ubicación actual con la transformación geoespacial.

La precisión del posicionamiento puede ser demasiado baja si la información de VPS no está disponible. La app debe estar conectada a Internet, y el VPS debe conocer la ubicación. Para obtener mejores resultados, ejecuta la app de ejemplo al aire libre (no en interiores) durante el día.

Además, si te encuentras en un área que no admite VPS o si los indicadores de GPS no son suficientes, es posible que debas ajustar los umbrales de confianza en la app para colocar un ancla.

Para ajustar los umbrales, sigue estos pasos:

  1. En Xcode, abre el archivo ViewController.m y navega a la siguiente sección:

    // Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

  2. Ajusta estos valores según sea necesario. Cuanto mayor sea el valor, menor será la precisión.

    Reducir la precisión permite que la app tenga una mayor latitud para colocar un ancla. Consulta Ajusta la precisión de la transformación para obtener más información.

Próximos pasos

Revisa la guía para desarrolladores de Geospatial para iOS y comienza a compilar con la API de Geospatial.