Guia de início rápido geoespacial para iOS

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

Para saber como desenvolver seu próprio app com a API Geospatial, consulte o guia para desenvolvedores da API Geospatial para iOS.

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

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

Pré-requisitos

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

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 do GitHub para acessar o código de exemplo do app.

  2. Abra uma janela do Terminal ou do Finder 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 Examples, selecione a pasta GeospatialExample e clique em Open.

Configurar um projeto do Google Cloud

Antes de usar o sistema de posicionamento visual (VPS) no seu app, é necessário ativar a API ARCore em um projeto novo ou existente do Google Cloud. Embora a API Geospatial funcione com a autorização de chaves e de chaves de API, use o método de chave de API neste guia de início rápido.

configurar a autorização

Para fazer chamadas da API Geospatial para o VPS, o app de exemplo precisa de autorização e pode usar uma chave de API sem restrições. Se você usar uma chave de API restrita, também precisará fornecer um ID de pacote para associar à chave de API.

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

  2. Adicione sua chave de API ao GARSession: cole a chave de API copiada de uma etapa anterior sobre o texto sua-chave-de-api (deixe as aspas), como mostrado:

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

Configurar o SDK do ARCore

O app GeospatialExample vem 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 Xcode está.

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

Criar e executar o app de exemplo

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

  2. Marque a caixa Gerenciar assinaturas automaticamente.

  3. No campo Equipe, insira um nome.

    Você pode usar o identificador de pacote padrão para executar o app no Xcode, mas é necessário mudar se você usar o GeospatialExample como um stub para seu próprio app em produção.

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

  5. Crie e execute o app GeospatialExample usando o arquivo .xcworkspace para iniciar no dispositivo.

    Para evitar erros de build, verifique se você está criando com base no arquivo .xcworkspace e não no arquivo .xcodeproj.

Você vai ver uma visualização da câmera e 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 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 transformação geoespacial.

A precisão do posicionamento pode ser muito baixa se as informações do 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 do lado de fora (não dentro de casa) durante o dia.

Além disso, se você estiver em uma área que não oferece 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.

    A redução da precisão permite que o app tenha maior liberdade para posicionar uma âncora. Consulte Ajustar a precisão da transformação para mais informações.

Próximas etapas

Consulte o guia para desenvolvedores de geolocalização para iOS e comece a criar com a API Geospatial.