As âncoras geoespaciais são um tipo de âncora que permite colocar conteúdo 3D no mundo real.
Tipos de âncoras geoespaciais
Existem três tipos de âncoras geoespaciais, que processam a altitude de maneira diferente:
Âncoras WGS84:
As âncoras WGS84 permitem colocar conteúdo 3D em qualquer latitude, longitude e altitude.Âncoras de terreno:
As âncoras de terreno permitem posicionar conteúdo usando somente latitude e longitude com uma altura relativa ao terreno naquela posição. A altitude é determinada em relação ao solo ou ao andar, como conhecido pelo VPS.Fixos de telhado:
As âncoras no telhado permitem que você posicione conteúdo usando somente latitude e longitude com uma altura relativa ao telhado de um edifício naquela posição. A altitude é determinada em relação ao topo de um edifício, como conhecido da Streetscape Geometry. Por padrão, a altitude do terreno será definida quando não estiver em uma construção.
WGS84 | Relevo | Telhado | |
---|---|---|---|
Posição horizontal | Latitude, longitude | Latitude, longitude | Latitude, longitude |
Posição vertical | Relativa à altitude do WGS84 | Relativa ao nível do terreno determinado pelo Google Maps | Relativa ao nível do telhado determinado pelo Google Maps |
Precisa ser resolvido pelo servidor? | Não | Sim | Sim |
Pré-requisitos
Ative a API Geospatial antes de continuar.
Posicionar âncoras geoespaciais
Cada tipo de âncora possui APIs dedicadas para criá-las; consulte Tipos de âncoras geoespaciais para mais informações.
Criar uma âncora a partir de um teste de hit
Você também pode criar uma âncora geoespacial com um resultado de teste de hit.
Usar a transformação do teste de hit e convertê-la em um GARGeospatialTransform
. Use-o para posicionar qualquer um dos três tipos de âncora descritos.
Como conseguir uma transformação geoespacial com uma transformação de RA
O GARSession.geospatialTransformFromTransform:error:
oferece outra maneira de determinar a latitude e a longitude convertendo uma transformação de RA em uma transformação geoespacial.
Como conseguir uma transformação de RA com uma transformação geoespacial
GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error:
converte uma posição horizontal, altitude e rotação de quatérnio especificadas pela Terra em relação a um frame de coordenadas leste-sul em uma transformação AR em relação à coordenada mundial GL.
Escolha o método ideal para seu caso de uso
Cada método de criação de uma âncora apresenta compensações associadas que devem ser lembradas:
- Ao usar o Streetscape Geometry, usar um teste de hit para anexar conteúdo a um edifício.
- Prefira âncoras de terreno ou telhado em vez de âncoras WGS84 porque elas usam valores de altitude determinados pelo Google Maps.
Determinar a latitude e a longitude de um local
Há três maneiras de calcular a latitude e a longitude de um local:
- Use o Geospatial Creator para ver e ampliar o mundo com conteúdo em 3D sem precisar ir fisicamente a um local. Isso permite posicionar visualmente o conteúdo imersivo em 3D usando o Google Maps no Unity Editor. A latitude, longitude, rotação e altitude do conteúdo serão calculadas automaticamente.
- Usar o Google Maps
- Usar o Google Earth. Observe que a obtenção dessas coordenadas usando o Google Earth, e não o Google Maps, lhe dará uma margem de erro de até vários metros.
- Ir para o local físico
Usar o Google Maps
Para conferir a latitude e a longitude de um local usando o Google Maps, faça o seguinte:
Acesse o Google Maps no seu computador desktop.
Navegue até Camadas > Mais.
Mude a opção Tipo de mapa para Satélite e desmarque a caixa de seleção Visualização de globo no canto inferior esquerdo da tela.
Isso forçará uma perspectiva 2D e eliminará possíveis erros que podem vir de uma visualização 3D inclinada.
No mapa, clique com o botão direito do mouse no local e selecione a longitude/latitude para copiá-lo para a área de transferência.
Usar o Google Earth
Para calcular a latitude e a longitude de um local no Google Earth, clique em um local na interface e leia os dados dos detalhes do marcador.
Para conferir a latitude e a longitude de um local usando o Google Earth:
Acesse o Google Earth em um computador desktop.
Navegue até o menu de navegação
e selecione Estilo do mapa.
Desative a opção Construções em 3D.
Depois que a opção Construções em 3D for desativada, clique no ícone de fixação
para adicionar um marcador de local no local selecionado.
Especifique um projeto que contenha seu marcador de local e clique em Salvar.
No campo Título do marcador de local, insira um nome para ele.
Clique na seta para voltar
no painel do projeto e selecione o menu
Mais ações.
Escolha Exportar como arquivo KML no menu.
O arquivo KLM informa a latitude, longitude e altitude de um marcador na tag <coordinates>
separados por vírgulas, da seguinte forma:
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
Não use a latitude e a longitude das tags <LookAt>
, que especificam a posição da câmera, não o local.
Ir para o local físico
Você pode calcular a altitude de um local indo até lá fisicamente e fazendo uma observação local.
Acessar o quatérnio de rotação
GARGeospatialTransform.eastUpSouthQTarget
extrai a orientação de uma transformação geoespacial e gera um quatérnio que representa a matriz de rotação que transforma um vetor do alvo para o sistema de coordenadas leste-para-sul (EUS). X+ pontos para leste, Y+ pontos para cima e Z+ pontos para sul. Os valores são gravados na ordem {x, y, z, w}
.
Âncoras WGS84
Uma âncora WGS84 é um tipo de âncora que permite posicionar conteúdo 3D em qualquer latitude, longitude e altitude. Ela depende de uma transformação e de orientação para ser colocada no mundo real. A posição consiste em latitude, longitude e altitude, que são especificadas no sistema de coordenadas WGS84. A orientação consiste em uma rotação de quatérnio.
A altitude é informada em metros acima do elipsoide de referência WGS84, de modo que o nível do solo não seja zero. Seu aplicativo é responsável por fornecer essas coordenadas para cada âncora criada.
Coloque uma âncora WGS84 no mundo real
Determinar a altitude de um local
Existem algumas maneiras de determinar a altitude de um local para colocar âncoras:
- Se o local da âncora estiver fisicamente perto do usuário, você poderá usar uma altitude semelhante à do dispositivo do usuário.
- Quando você tiver a latitude e a longitude, use a API Elevation para conferir uma elevação com base na especificação EGM96. Você precisa converter a elevação EGM96 da API Maps em WGS84 para comparação com a altitude de
GARGeospatialTransform
. Veja o GeoidEval, que tem uma interface de linha de comando e uma HTML. A API do Google Maps informa a latitude e longitude de acordo com a especificação WGS84 pronta para uso. - Você pode obter a latitude, longitude e altitude de um local no Google Earth. Isso lhe dará uma margem de erro de até vários metros. Use a latitude, a longitude e a altitude das tags
<coordinates>
, não das tags<LookAt>
, no arquivo KML. - Se um ponto âncora estiver próximo e você não estiver em uma subida íngreme, poderá usar a altitude do
GARGeospatialTransform
da câmera sem outra fonte, como a API Maps.
Criar a âncora
Depois de ter a latitude, a longitude, a altitude e o quatérnio da rotação, use createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error:
.
para fixar o conteúdo nas coordenadas geográficas especificadas.
NSError *error = nil;
GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
altitude:altitude
eastUpSouthQAnchor:eastUpSouthQAnchor
error:&error];
Âncoras para terrenos
Uma âncora de terreno é um tipo de âncora que permite posicionar objetos de RA usando somente latitude e longitude, aproveitando informações do VPS para encontrar a altitude precisa acima do solo.
Em vez de inserir a altitude desejada, você fornece a altitude acima do terreno. Quando esse valor é zero, a âncora fica nivelada com o terreno.
Definir o modo de descoberta de avião
A localização de planos é opcional e não é obrigatória para o uso de âncoras. Somente planos horizontais são usados. Planos horizontais ajudam no alinhamento dinâmico das âncoras de terreno no solo.
Use ARWorldTrackingConfiguration.PlaneDetection
para selecionar como o app detecta planos.
Criar uma âncora de terreno usando a nova API assíncrona
Para criar e posicionar uma âncora de terreno, chame GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:
.
O anúncio âncora não estará pronto imediatamente e precisa ser resolvido. Após a resolução, ela vai estar disponível no GARCreateAnchorOnTerrainFuture
.
GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveTerrain:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
// handle completion
}
error:&error];
Confira o estado do futuro
O Future terá um GARFutureState
associado.
Estado | Descrição |
---|---|
GARFutureStatePending |
A operação ainda está pendente. |
GARFutureStateDone |
A operação foi concluída e o resultado está disponível. |
GARFutureStateCancelled |
A operação foi cancelada. |
Verificar o estado da âncora do terreno do resultado Futuro
O GARTerrainAnchorState
pertence à operação assíncrona e faz parte do resultado final do Future.
switch (future.resultTerrainAnchorState) {
case GARTerrainAnchorStateSuccess:
// Terrain anchor finished resolving.
break;
case GARTerrainAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARTerrainAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARTerrainAnchorStateErrorInternal:
// The Terrain anchor could not be resolved due to an internal error.
break;
default:
break;
}
Âncoras para telhados
As âncoras de telhado são um tipo de âncora e são muito semelhantes às Âncoras de terreno acima. A diferença é que você fornecerá a altitude acima do telhado em vez de fornecer a altitude acima do terreno.
Criar uma âncora Rooftop usando a nova API Async
O anúncio âncora não estará pronto imediatamente e precisa ser resolvido.
Para criar e posicionar uma âncora no telhado, chame GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:
. Assim como nas âncoras de terreno, você também acessa o GARFutureState
do futuro. Em seguida, marque o resultado futuro para acessar o GARRooftopAnchorState
.
GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveRooftop:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
// handle completion
}
error:&error];
Confira o estado do futuro
A classe Future terá um GARFutureState
associado. Consulte a tabela acima.
Verificar o estado da âncora no telhado do resultado Future
O GARRooftopAnchorState
pertence à operação assíncrona e faz parte do resultado final do Future.
switch (future.resultRooftopAnchorState) {
case GARRooftopAnchorStateSuccess:
// Rooftop anchor finished resolving.
break;
case GARRooftopAnchorStateErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case GARRooftopAnchorStateErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState#garrooftopanchorstateerrornotauthorized
// for troubleshooting steps.
break;
case GARRooftopAnchorStateErrorInternal:
// The Rooftop anchor could not be resolved due to an internal error.
break;
default:
break;
}
A seguir
- Entenda a cota de uso da API Geospatial.