Guia de início rápido geoespacial para Android

Este guia de início rápido da API ARCore Geospatial mostra como executar um app de exemplo no Android Studio que demonstra a API Geospatial.

Para acessar um guia de como desenvolver seu próprio app com a API Geospatial, acesse o Guia do desenvolvedor geoespacial para Android (Kotlin/Java) ou o Guia do desenvolvedor geoespacial do Android NDK (C).

Consulte a Introdução à API ARCore Geospatial para saber mais informações sobre a API Geospatial.

Se você está começando a desenvolver com o ARCore, consulte Primeiros passos.

Requisitos

Suporte do dispositivo

Consulte Dispositivos compatíveis para ver uma lista completa dos dispositivos que receberam certificação para trabalhar com ARCore. Na API Geospatial, um dos principais hardware necessário é um magnetômetro que atende à API Geospatial especificações. Alguns magnetômetros não atendem à especificação. dispositivos com estes magnetômetros fora da especificação não são compatíveis.

Software

  • A versão mais recente do Google Play Services para RA instalado no dispositivo compatível.

  • Android Studio versão 3.0 ou mais recente com a Android SDK Platform versão 7.0 (nível 24 da API) ou mais recente

  • O SDK do ARCore para Android, que você pode obter de duas maneiras:

    • Baixar de GitHub e extraia-o na sua máquina.

    • Clone o repositório com o seguinte comando: 

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

Abrir e configurar o app de exemplo

O projeto geospatial_java incluído no SDK do ARCore para Android descreve o código que chama a API Geospatial.

  1. No Android Studio, no menu File, clique em Open.

  2. Navegue até a pasta do projeto arcore-android-sdk.

  3. Abra a pasta samples, selecione a pasta geospatial_java e clique em Abrir.

Configurar um projeto do Google Cloud

Para usar o Sistema de Posicionamento Visual (VPS), seu app precisa estar associado a um projeto do Google Cloud ativado para a API ARCore. Consulte Usar a API ARCore no Google Cloud para configurar a autorização. Você pode escolher a autorização com ou sem chave de API.

Executar o app de amostra

No Android Studio, execute o app de exemplo.

Você terá acesso a uma imagem da câmera, além das informações de depuração que descrevem a posição geoespacial atual do dispositivo. Ao verificar o ambiente ao seu redor, observe que os valores de confiança da precisão de posicionamento podem mudar conforme você se move, se estiver em uma área com suporte à localização do VPS.

Quando o ARCore estiver confiante na localização e no rumo do dispositivo, você poderá colocar uma âncora no local atual usando a pose geoespacial.

A precisão do posicionamento pode ser muito baixa se as informações do VPS não estiverem disponíveis. O O app precisa estar conectado à Internet, e o VPS precisa saber a localização. Para melhores resultados, execute o app de exemplo ao ar livre (não em ambientes fechados) durante o dia.

Além disso, se você estiver em uma área onde não há suporte para VPS ou se os sinais de GPS não estiverem suficiente, talvez seja necessário ajustar os limites de confiança no aplicativo para para colocar uma âncora.

Para ajustar os limites:

  1. No Android Studio, abra a GeospatialActivity e navegue até a seguinte seção:

    // 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. Ajuste esses valores conforme necessário. Quanto maior o valor, menor a precisão.

    Diminuir a precisão permite que o app tenha uma latitude maior ao posicionar uma âncora. Consulte Ajustar para a precisão da pose para mais informações.

Próximas etapas