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 com a API Geospatial.

Se quiser aprender a desenvolver seu próprio app com a API Geospatial, consulte o Guia do desenvolvedor geoespacial para Android (Kotlin/Java) ou o Guia do desenvolvedor geoespacial para Android NDK (C).

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

Se você não tem experiência com o desenvolvimento com o ARCore, consulte os Primeiros passos.

Requisitos

Suporte do dispositivo

Consulte Dispositivos compatíveis para ver uma lista completa de dispositivos certificados para funcionar com o ARCore. Para a API Geospatial, um dos principais componentes de hardware necessários é um magnetômetro que atende às especificações da API Geospatial. Alguns magnetômetros não atendem à especificação. Dispositivos com esses magnetômetros fora da especificação não são compatíveis.

Software

  • A versão mais recente do Google Play Services para RA instalada no dispositivo com suporte.

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

  • O SDK do ARCore para Android, que pode ser recebido de duas maneiras:

    • Faça o download dele no 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 menu File do Android Studio, 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, na sigla em inglês), 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. É possível escolher a autorização sem chave ou por chave de API.

Executar o app de amostra

No Android Studio, execute o app de exemplo.

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

Quando o ARCore confiar na localização e na direção do seu dispositivo, você poderá colocar uma Âncora no seu local atual usando a pose geoespacial.

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

Além disso, se você estiver em uma área sem suporte ao VPS ou se os sinais de GPS não forem suficientes, talvez seja necessário ajustar os limites de confiança no app para colocar uma âncora.

Para ajustar os limites:

  1. No Android Studio, abra 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 colocar uma âncora. Consulte Ajustar a precisão da pose para mais informações.

Próximas etapas