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 muestra la API de Geospatial.

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

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

Si es la primera vez que desarrollas con ARCore, consulta Primeros pasos.

Requisitos

Dispositivos compatibles

Consulta la sección Dispositivos compatibles para obtener una lista completa de los dispositivos que tener la certificación para trabajar con ARCore. En el caso de la API de Geospatial, uno de los elementos de hardware clave que se requiere es un magnetómetro que cumpla con las especificaciones de la API de Geospatial. Algunos magnetómetros no cumplen con las especificaciones. dispositivos con estas no se admiten magnetómetros que no cumplan con las especificaciones.

Software

  • La última versión de Servicios de Google Play para RA instalada en el dispositivo compatible.

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

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

    • Descárgala de GitHub y extraerlo de tu máquina.

    • Clona el repositorio con el siguiente comando: 

      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 aplicación debe estar asociada con un proyecto de Google Cloud habilitado para la API de ARCore Consulta Usa la API de ARCore en Google Cloud para configurar la autorización. Puedes elegir entre la autorización sin clave o con la clave de API.

Ejecuta la app de muestra

En Android Studio, ejecuta la app de ejemplo.

Deberías poder tener una vista de cámara, junto con la información de depuración que describa la pose geoespacial actual de tu dispositivo. A medida que exploras el entorno, Notará que los valores de confianza de la precisión del posicionamiento pueden cambiar si te encuentras en un área que admite la localización de VPS.

Cuando ARCore esté seguro de la ubicación y la orientación de tu dispositivo, podrás colocar un Anclar en tu ubicación actual con la pose geoespacial.

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

Además, si te encuentras en un área que no admite VPS o si las señales de GPS no están suficiente, quizás debas ajustar los umbrales de confianza en la app para 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.

    Disminuir la precisión permite que la app tenga una mayor latitud para colocar un ancla. Consulta Realiza ajustes para lograr la precisión de la postura para obtener más información.

Próximos pasos