Las anclas geoespaciales son un tipo de ancla que te permiten colocar contenido 3D en el mundo real.
Tipos de anclas geoespaciales
Existen tres tipos de anclas geoespaciales, cada una de las cuales controla la altitud de forma diferente:
Anclas WGS84:
Las anclas WGS84 te permiten colocar contenido 3D en cualquier latitud, longitud y altitud determinadas.Anclas de relieve:
Las anclas de relieve te permiten colocar contenido utilizando solo la latitud y con una altura relativa al terreno en esa posición. La altitud se determina en relación con el suelo o el piso, según de VPS.Anclas de techo:
Las anclas de techo te permiten colocar contenido utilizando solo la latitud y con una altura relativa al techo de un edificio en esa posición. La altitud se determina en relación con la parte superior de un edificio, como se conoce por Streetscape Geometry. De forma predeterminada, se establecerá la altitud del terreno cuando no se coloque en un edificio.
| WGS84 | Terreno | En la azotea | |
|---|---|---|---|
| Posición horizontal | Latitud y longitud | Latitud y longitud | Latitud y longitud |
| Posición vertical | En relación con la altitud WGS84 | Relativo al nivel del terreno determinado por Google Maps. | En relación con el nivel de la azotea determinado por Google Maps |
| ¿Se debe resolver en el servidor? | No | Sí | Sí |
Requisitos previos
Asegúrate de habilitar la API de Geospatial antes de continuar.
Coloca anclas geoespaciales
Cada tipo de ancla tiene APIs dedicadas para crearlas. Consulta Tipos de anclas geoespaciales para obtener más información.
Crea un ancla a partir de una prueba de posicionamiento
También puedes crear un ancla geoespacial a partir de un resultado de prueba de resultado.
Usa la transformación de la prueba de posicionamiento y conviértela en una GARGeospatialTransform. Úsala para colocar cualquiera de los 3 tipos de anclas descritos.
Cómo obtener una transformación geoespacial a partir de una transformación de RA
GARSession.geospatialTransformFromTransform:error: proporciona una forma adicional de determinar la latitud y longitud mediante la conversión de una transformación de RA en una transformación geoespacial.
Obtén una transformación de RA a partir de una transformación geoespacial
GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error: convierte una posición horizontal, una altitud y una rotación de cuaternion especificadas por la Tierra con respecto a un marco de coordenadas este-arriba-sur en una transformación de RA con respecto a la coordenada mundial de GL.
Elige el método que se adapte a tu caso de uso
Cada método de creación de un ancla tiene compensaciones asociadas que se deben tener en cuenta:
- Cuando uses la geometría del paisaje urbano, usar una prueba de posicionamiento para adjuntar contenido a un edificio.
- Prefiere los anclas de terreno o techos en lugar de los anclas WGS84, ya que usan valores de altitud determinados por Google Maps.
Determina la latitud y longitud de una ubicación
Hay tres formas de calcular la latitud y longitud de una ubicación:
- Usa el Creador de Geospatial para ver y aumentar el mundo con contenido en 3D sin tener que ir físicamente a una ubicación. Esto te permite colocar contenido envolvente en 3D de forma visual con mapas de Google Maps en Unity Editor. La latitud, la longitud, la rotación y la altitud del contenido se calcularán automáticamente.
- Usar Google Maps
- Usa Google Earth. Ten en cuenta que si obtienes estas coordenadas con Google Earth, en lugar de hacerlo con Google Maps, obtendrás un margen de error de hasta varios metros.
- Ve a la ubicación física
Usar Google Maps
Para obtener la latitud y longitud de una ubicación con Google Maps, sigue estos pasos:
Ve a Google Maps en tu computadora de escritorio.
Navega a Capas > Más.
Cambia el Tipo de mapa a Satélite y borra la casilla de verificación Vista de globo en la esquina inferior izquierda de la pantalla.
Esto forzará una perspectiva 2D y eliminará los posibles errores que podrían provenir de una vista en 3D en ángulo.
En el mapa, haz clic con el botón derecho en la ubicación y selecciona la longitud o latitud para copiarlas en el portapapeles.
Cómo usar Google Earth
Para calcular la latitud y la longitud de una ubicación desde Google Earth, haz clic en una ubicación de la IU y lee los datos de los detalles del marcador de posición.
Para obtener la latitud y la longitud de una ubicación con Google Earth, sigue estos pasos:
Ve a Google Earth en tu computadora de escritorio.
Navega al menú de opciones
y selecciona Diseño de mapa.Desactiva el interruptor Edificios 3D.
Una vez que se haya desactivado el interruptor Edificios 3D, haz clic en el ícono de pin
para agregar un marcador de posición en la ubicación seleccionada.Especifica un proyecto que contenga el marcador y haz clic en Guardar.
En el campo Título del marcador, ingresa un nombre para él.
Haz clic en la flecha hacia atrás
en el panel del proyecto y selecciona el menú 
Más acciones.Elige Exportar como archivo KML en el menú.
El archivo KLM informa la latitud, la longitud y la altitud de un marcador de posición en la etiqueta <coordinates>, separados por comas, de la siguiente manera:
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
No uses la latitud y longitud de las etiquetas <LookAt>, que especifican la posición de la cámara, no la ubicación.
Ve a la ubicación física
Para calcular la altitud de una ubicación, ve allí físicamente y realiza una observación local.
Obtén el cuaternión de rotación
GARGeospatialTransform.eastUpSouthQTarget extrae la orientación de una transformación geoespacial y genera un cuaternión que representa la matriz de rotación que transforma un vector del objetivo al sistema de coordenadas este-a-sur (EUS). X+ apunta al este, Y+ apunta hacia arriba y Z+ apunta al sur. Los valores se escriben en el orden {x, y, z, w}.
Anclas WGS84
Un ancla WGS84 es un tipo de anclaje que te permite colocar contenido 3D en cualquier latitud, longitud y altitud determinadas. Se basa en una transformación y una orientación para ubicarse en el mundo real. La posición consta de una latitud, una longitud y una altitud, que se especifican en el sistema de coordenadas WGS84. La orientación consiste en una rotación de cuaternión.
La altitud se informa en metros sobre el elipsoide de referencia WGS84, de modo que el nivel del suelo no sea cero. Tu app es responsable de proporcionar estas coordenadas para cada ancla creada.
Coloca un ancla WGS84 en el mundo real
Cómo determinar la altitud de una ubicación
Existen varias formas de determinar la altitud de una ubicación para colocar anclas:
- Si la ubicación del ancla se encuentra físicamente cerca del usuario, puedes utilizar una altitud similar a la del dispositivo del usuario.
- Una vez que tengas la latitud y la longitud, usa la API de Elevation para obtener una elevación basada en la especificación EGM96. Debes convertir la elevación de EGM96 de la API de Google Maps a WGS84 para compararla con la altitud de
GARGeospatialTransform. Consulta GeoidEval, que tiene una línea de comandos y una interfaz HTML. La API de Maps informa la latitud y la longitud según la especificación WGS84 de forma predeterminada. - Puedes consultar la latitud, la longitud y la altitud de una ubicación en Google Earth. Aparecerá un margen de error de hasta varios metros. Utiliza la latitud, la longitud y la altitud de las etiquetas
<coordinates>, no las etiquetas<LookAt>, en el archivo KML. - Si hay un ancla existente cerca y no estás en una pendiente pronunciada, es posible que puedas usar la altitud de
GARGeospatialTransformde la cámara sin usar otra fuente, como la API de Maps.
Crea el ancla
Una vez que tengas la latitud, la longitud, la altitud y el cuaternion de rotación, usa createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error: para fijar el contenido a las coordenadas geográficas que especifiques.
NSError *error = nil;
GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
altitude:altitude
eastUpSouthQAnchor:eastUpSouthQAnchor
error:&error];
Anclajes de terreno
Un ancla de terreno es un tipo de ancla que te permite colocar objetos de RA solo usando la latitud y la longitud, y aprovechando la información del VPS para encontrar la altitud precisa sobre el suelo.
En lugar de ingresar la altitud deseada, proporcionas la altitud sobre el terreno. Cuando el valor sea cero, el ancla estará nivelada con el terreno.
Configura el modo de búsqueda de aviones
La búsqueda de planos es opcional y no es obligatorio para usar anclas. Ten en cuenta que solo se usan planos horizontales. Los planos horizontales ayudarán a la alineación dinámica de las anclas de terreno en el suelo.
Usa ARWorldTrackingConfiguration.PlaneDetection para seleccionar cómo detecta aviones tu app.
Cómo crear un ancla de terreno con la nueva API de Async
Para crear y colocar un ancla de relieve, llama a GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:.
El ancla no estará lista de inmediato y debe resolverse. Una vez que se resuelva, estará disponible en GARCreateAnchorOnTerrainFuture.
GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveTerrain:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
// handle completion
}
error:&error];
Verifica el estado del futuro
La interfaz Future tendrá un GARFutureState asociado.
| Estado | Descripción |
|---|---|
GARFutureStatePending |
La operación aún está pendiente. |
GARFutureStateDone |
La operación se completó y el resultado está disponible. |
GARFutureStateCancelled |
Se canceló la operación. |
Verifica el estado del ancla de terreno del resultado futuro
El GARTerrainAnchorState pertenece a la operación asíncrona y forma parte del resultado final de 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;
}
Anclajes para techos
Los anclajes de techo son un tipo de anclaje y son muy similares a los anclajes de terreno mencionados anteriormente. La diferencia es que debes proporcionar la altitud sobre la azotea en lugar de la altitud sobre el terreno.
Cómo crear un ancla de techo con la nueva API de Async
El ancla no estará lista de inmediato y debe resolverse.
Para crear y colocar un ancla de techo, llama a GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:. De manera similar a las anclas de terreno, también accederás a la GARFutureState del futuro. Luego, puedes verificar el resultado Future para acceder a GARRooftopAnchorState.
GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveRooftop:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
// handle completion
}
error:&error];
Verifica el estado del futuro
El futuro tendrá un GARFutureState asociado. Consulta la tabla anterior.
Verifica el estado de la ancla de techo del resultado futuro
El GARRooftopAnchorState pertenece a la operación asíncrona y es parte del resultado futuro final.
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;
}
¿Qué sigue?
- Asegúrate de comprender la cuota de uso de la API de Geospatial.