Depois de definir as configurações do app para usar a API Geospatial, você pode acessar o AREarthManager.CameraGeospatialPose
da câmera do dispositivo. Essa pose, gerenciada em um objeto AREarthManager
, contém as seguintes informações:
- Local, expresso em latitude e longitude.
- Altitude
- Uma orientação que se aproxima da direção do usuário no sistema de coordenadas EUS, com X+ apontando para o leste, Y+ apontando para cima e Z+ apontando para o sul.
Verificar o estado do acompanhamento
Os valores geoespaciais são válidos apenas quando AREarthManager.EarthTrackingState
é TrackingState.Tracking
. Envolva todas as chamadas de API Geospatial em um bloco de controle AREarthManager.EarthTrackingState
.
var earthTrackingState = EarthManager.EarthTrackingState;
if (earthTrackingState == TrackingState.Tracking)
{
// camera_geospatial_pose contains geodetic location, rotation, and
// confidences values.
var cameraGeospatialPose = EarthManager.CameraGeospatialPose;
}
Se AREarthManager.EarthTrackingState
não se tornar TrackingState.Tracking
, AREarthManager.EarthTrackingState
poderá ser TrackingState.Limited
ou TrackingState.None
. Se nenhuma dessas condições for verdadeira, marque TrackingState.EarthTrackingState
, que mostra outros estados de erro que podem impedir o rastreamento do objeto AREarthManager
.
Ajustar a pose para ter precisão
Quando o dispositivo está na posição vertical na orientação padrão, os ângulos de inclinação (X+) e rolagem (Z+) tendem a ser precisos devido a um alinhamento natural com o rastreamento em RA. No entanto, os ângulos de guinada (Y+) podem variar dependendo da disponibilidade de dados do VPS e das condições temporais no local. Talvez o app precise fazer ajustes para aumentar a precisão.
GeospatialPose.OrientationYawAccuracy
fornece uma estimativa de precisão para os ângulos de guinada (Y+) de um determinado AREarthManager.CameraGeospatialPose
. A precisão da guinada da orientação é um número que descreve o raio, em graus, do nível de confiança do 68o percentil em torno dos ângulos de guinada em GeospatialPose.EunRotation
. Em outras palavras, há 68% de chance de que o ângulo de guinada real da AREarthManager.CameraGeospatialPose
seja preciso dentro do número de graus retornado por
GeospatialPose.OrientationYawAccuracy
.
Valores maiores indicam menor acurácia. Por exemplo, se o ângulo de guinada estimado for de 60 graus e a precisão da guinada é de 10 graus, há uma probabilidade de 68% de que o ângulo de guina real esteja entre 50 e 70 graus.
A seguir
- Coloque uma âncora geoespacial usando a pose geoespacial dela.