Ativar a API Geospatial no app iOS

Configure as configurações do app para que ele possa usar a API Geospatial.

Pré-requisitos

Entenda os conceitos básicos de RA e como configurar uma sessão do ARCore antes de continuar.

Se você quiser executar um app de exemplo que demonstre a funcionalidade descrita aqui, consulte o Início rápido da API Geospatial do ARCore para iOS.

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

Se você é iniciante no desenvolvimento com o ARCore, consulte Primeiros passos para informações sobre requisitos de software e hardware, pré-requisitos e outras informações específicas das plataformas que você está usando.

Ativar a API ARCore

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. Esse serviço é responsável por hospedar, armazenar e resolver âncoras geoespaciais.

A autorização sem chave é a preferida, mas a autorização de chave de API também é aceita.

Adicionar as bibliotecas necessárias ao app

Depois de autorizar o app a chamar a API ARCore, adicione bibliotecas para ativar os recursos geoespaciais no app.

Atualize o Podfile do app para incluir o SDK do ARCore e a versão do iOS com suporte. Para fazer isso:

  1. Adicione os seguintes platform e pod ao Podfile do projeto:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.46.0'

    Você também pode especificar platform :ios, '10.0' se quiser oferecer suporte ao iOS 10. No entanto, a API Geospatial só vai funcionar no momento da execução no iOS >= 11.

  2. Abra uma janela do Terminal e execute pod install na pasta em que o projeto Xcode está.

    Isso gera um arquivo .xcworkspace que você usa para criar e executar o app.

Confira se o ambiente de desenvolvimento atende aos requisitos do SDK do ARCore, conforme descrito no Quickstart.

Ativar os recursos geoespaciais na configuração da sessão

Verificar a compatibilidade do dispositivo

Nem todos os dispositivos compatíveis com o ARCore também são compatíveis com a API Geospatial, conforme descrito no Guia de início rápido.

Use GARSession.isGeospatialModeSupported: para verificar o dispositivo, como no exemplo a seguir:

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

Pedir permissões de localização ao usuário durante a execução

Seu app precisa solicitar as seguintes permissões de localização durante a execução antes de configurar a sessão:

Verificar a disponibilidade geoespacial no local atual do dispositivo

Como a API Geospatial usa uma combinação de VPS e GPS para determinar uma transformação geoespacial, ela pode ser usada desde que o dispositivo consiga determinar a própria localização. Em áreas com baixa precisão de GPS, como espaços internos e ambientes urbanos densos, a API vai depender da cobertura de VPS para gerar transformações de alta precisão. Em condições normais, o VPS pode fornecer uma precisão posicional de aproximadamente 5 metros e uma precisão de rotação de 5 graus. Use GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: para determinar se um determinado local tem cobertura de VPS.

A API Geospatial também pode ser usada em áreas sem cobertura de VPS. Em ambientes externos com poucas ou nenhuma obstrução, o GPS pode ser suficiente para gerar uma transformação com alta precisão.

A seguir