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

En esta guía de inicio rápido para la API de ARCore Geospatial, se muestra cómo ejecutar una app de ejemplo en Android Studio que demuestre la API de Geospatial.

Si deseas obtener una guía para desarrollar tu propia app con la API de Geospatial, consulta la Guía para desarrolladores de Geospatial para Android (Kotlin/Java) o la guía para desarrolladores de Geospatial para el NDK de Android (C).

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

Asistencia para dispositivos

Consulta Dispositivos compatibles a fin de obtener una lista completa de los dispositivos certificados para funcionar con ARCore. Para la API de Geospatial, una de las piezas clave de hardware requeridas es un magnetómetro que cumpla con las especificaciones de la API de Geospatial. Algunos magnetómetros no cumplen con las especificaciones. Los dispositivos con estos magnetómetros que no cumplen con las especificaciones no son compatibles.

Software

  • La versión más reciente de los Servicios de Google Play para RA instalada en el dispositivo compatible

  • Android Studio versión 3.0 o posterior con la plataforma del SDK de Android versión 7.0 (nivel de API 24) o una versión posterior

  • El SDK de ARCore para Android, que puedes obtener de una de dos maneras:

    • Descárgala desde GitHub y extráela en tu máquina.

    • Usa el siguiente comando para clonar el repositorio: 

      git clone https://github.com/google-ar/arcore-android-sdk.git

Abre y configura la app de ejemplo

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

  1. En Android Studio, en el menú File, haz clic en Open.

  2. Navega a la carpeta del proyecto de arcore-android-sdk.

  3. Abre la carpeta samples, selecciona la carpeta geospatial_java y haz clic en Open.

Configura un proyecto de Google Cloud

Para usar el sistema de posicionamiento visual (VPS), tu app debe estar asociada a un proyecto de Google Cloud habilitado para la API de ARCore. Consulta Cómo usar la API de ARCore en Google Cloud para configurar la autorización. Puedes elegir entre autorización sin clave o de clave de API.

Ejecuta la app de muestra

En Android Studio, ejecuta la app de ejemplo.

Deberías poder ver una vista de cámara, junto con información de depuración que describa la pose geoespacial actual de tu dispositivo. A medida que analizas el entorno que te rodea, observa que los valores de confianza de la precisión del posicionamiento pueden cambiar a medida que te desplazas si te encuentras en un área admitida por la localización de VPS.

Cuando ARCore confía en la ubicación y la orientación de tu dispositivo, puedes colocar un ancla en tu ubicación actual con la pose geoespacial.

Es posible que la precisión de posicionamiento sea demasiado baja si la información de los 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 en el exterior (no en el interior) durante el día.

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

Para ajustar los umbrales, haz lo siguiente:

  1. En Android Studio, abre GeospatialActivity y navega hasta la siguiente sección:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. Ajusta estos valores según sea necesario. Cuanto más alto sea el valor, menor será la exactitud.

    Reducir la exactitud permite que la app disponga de una latitud mayor para colocar un ancla. Si quieres obtener más información, consulta Cómo realizar ajustes para determinar la precisión de las poses.

Próximos pasos