Guia de início rápido geoespacial para iOS

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

Para aprender a desenvolver seu próprio app com a API Geospatial, consulte o Guia do desenvolvedor geoespacial para iOS.

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.

Pré-requisitos

  • Xcode versão 13.0 ou mais recente
  • Cocoapods 1.4.0 ou posterior, se estiver usando Cocoapods
  • Um dispositivo Apple compatível com ARKit que execute o iOS 12.0 ou posterior (destino de implantação do iOS 12.0 ou mais recente necessário)

Configurar o aplicativo de amostra

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

  1. Clone ou faça o download do SDK do ARCore para iOS no GitHub para conseguir o código do app de amostra.

  2. Abra uma janela de terminal ou localizador e navegue até a pasta em que você clonou ou fez o download do SDK.

  3. Navegue até a pasta arcore-ios-sdk-master/Examples.

  4. Abra a pasta Exemplos, selecione a pasta GeospatialExample 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.

É necessário ativar a API ARCore no seu projeto do Google Cloud. Se você precisar criar o projeto, faça o seguinte:

  1. Acesse Criar um projeto no Google Cloud Platform.

  2. Digite o nome do projeto e escolha um local para o Nome do projeto.

  3. Clique em Criar.

  4. Na barra lateral, selecione APIs e serviços e Biblioteca.

  5. Procure a API ARCore, selecione-a e clique em Ativar.

configure a autorização

Para fazer chamadas de API Geospatial para o VPS, o app de exemplo precisa de autorização e pode usar uma chave de API irrestrita. Se você usa uma chave de API restrita, forneça também um ID do pacote para associar à chave.

  1. No projeto do Google Cloud, consiga uma chave de API conforme descrito em Como criar uma chave de API.

  2. Copie a chave de API, como você vai colar, em uma etapa posterior.

  3. No Xcode, no app de exemplo GeospatialExample, abra o arquivo ViewController.m e procure your-api-key.

  4. Adicione sua chave de API ao GARSession: cole a chave de API que você copiou de uma etapa anterior no texto, your-api-key (deixe as aspas), conforme mostrado abaixo.

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

Configurar o SDK do ARCore

O app GeospatialExample é enviado com um Podfile pré-configurado com o SDK do ARCore e as versões do iOS necessárias. Para instalar essas dependências, abra uma janela do Terminal e execute pod install na pasta em que o projeto do Xcode existe.

Isso gera um arquivo .xcworkspace que você vai usar mais tarde para criar e executar o app.

Criar e executar o aplicativo de exemplo

  1. No Xcode, selecione o arquivo do espaço de trabalho GeospatialExample e clique em Signing & Capabilities.

  2. Marque a caixa Gerenciar a assinatura automaticamente.

  3. No campo Equipe, digite o nome de uma equipe.

    Você pode usar o Identificador do pacote padrão para executar o app a partir do Xcode, mas será necessário alterá-lo se você usar o GeospatialExample como um stub para seu próprio app em produção.

  4. Conecte seu dispositivo para executar o app de exemplo.

  5. Crie e execute o app GeospatialExample do arquivo .xcworkspace para iniciá-lo no seu dispositivo.

    Para evitar erros de build, verifique se você está criando a partir do arquivo .xcworkspace, e não do arquivo .xcodeproj.

Você vai encontrar uma visualização de câmera, além de informações de depuração que descrevem a transformação geoespacial atual do dispositivo. Ao verificar o ambiente ao seu redor, observe que os valores de confiança da precisão do posicionamento podem mudar conforme você se move, se você estiver em uma área compatível com a 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 transformação Geospatial.

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 Xcode, abra o arquivo ViewController.m e navegue até a seguinte seção:

    // 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. 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 para precisão de transformação para mais informações.

Próximas etapas

Consulte o guia do desenvolvedor Geospatial para iOS e comece a criar com a API Geospatial.