Questa guida descrive come utilizzare Geospatial Creator per scrivere script C#
per eseguire rapidamente attività comuni come la creazione e lo spostamento
ARGeospatialCreatorAnchor di oggetti nella modalità di modifica di Unity. Questo può essere utile per creare più ancore da un elenco predefinito, ad esempio un foglio di lavoro o un file KML.
Geospatial Creator in Unity ti consente di visualizzare l'anteprima dei contenuti geospaziali nell'Editor di Unity. La nostra guida rapida introduce Geospatial Creator e illustra come creare la tua prima esperienza AR con funzionalità geografiche con una programmazione minima utilizzando l'interfaccia utente di Unity Editor. Per progetti più avanzati, ti consigliamo di creare e manipolare gli oggetti GameObject di Geospatial Creator in modo programmatico anziché utilizzare l'interfaccia utente di Unity Editor.
Questa guida presuppone che tu abbia familiarità con i concetti di base di Geospatial Creator introdotti nella guida rapida e che tu sia pronto per iniziare ad aggiungere ancore di Geospatial Creator a una scena. Devi aver attivato e configurato Geospatial Creator con le tue chiavi API, nonché gli oggetti della sessione AR iniziale nella scena. Se parti da zero, segui la Guida rapida, inclusa la sezione "Attiva Creatore di dati geografici", prima di continuare.
Per iniziare
Per questo esempio, supponiamo che tu abbia un insieme di località note intorno al municipio di San Francisco, in California, Stati Uniti, in cui vuoi posizionare contenuti AR. Dovrai creare oggetti di ancoraggio in ciascuna di queste posizioni e poi collegare la geometria di base a questi ancoraggi.
Prima di poter creare ancore, devi specificare un ARGeospatialCreatorOrigin, che è un punto di riferimento per la conversione di latitudini, longitudini e altitudini verso e da coordinate mondiali di Unity.
L'origine conterrà anche un componente secondario CesiumGeoreference e un oggetto figlio Cesium3DTileset, che consente a Cesium di eseguire il rendering dell'area circostante nella visualizzazione Scena dell'editor Unity. Per farlo, devi disporre di una chiave API Google Maps Tiles come descritto nella guida rapida.
Creare un'origine
L'API per Geospatial Creator include un metodo di fabbrica per creare un
ARGeospatialCreatorOrigin nella scena e aggiungere i componenti Cesium richiesti.
Il codice seguente crea l'origine a una latitudine, longitudine e altitudine vicine e utilizza la chiave API Map Tiles specificata:
ARGeospatialCreatorOrigin origin =
GeospatialCreatorCesiumAdapter.CreateOriginWithCesiumGeoreference(
37.77954, -122.417581, 0.0, "<MAP_TILES_KEY>");
Per impostazione predefinita, questo oggetto è posizionato in (0, 0, 0) nelle coordinate mondiali di Unity, che funziona bene per questo esempio.
Recupera il riferimento ARAnchorManager
Per risolvere gli ancoraggi geospaziali in fase di esecuzione è necessario un ARAnchorManager, quindi devi anche avere un riferimento a ARAnchorManager nella scena. Se hai iniziato con
l'applicazione di esempio geospaziale inclusa in ARCore Extensions, Anchor
Manager è associato all'oggetto GameObject "AR Session Origin". Supponendo di avere esattamente un gestore di ancoraggio nella scena, puoi ottenere un riferimento come questo:
ARAnchorManager anchorManager =
Resources.FindObjectsOfTypeAll<ARAnchorManager>()[0];
Ora che hai un'origine e un gestore di ancore, puoi iniziare a creare gli oggetti ARGeospatialCreatorAnchor.
Crea ancore del terreno
Prendi in considerazione il seguente array bidimensionale di valori double, che rappresenta la latitudine e la longitudine precise in tre punti sul lato rivolto a est del municipio di San Francisco, in California, Stati Uniti:
double[,] _cityHallEastPoints = {
{ 37.77936, -122.418617 }, // in front of city hall
{ 37.77965, -122.418680 }, // right of city hall
{ 37.77917, -122.418577 }}; // left of city hall
Supponiamo di voler posizionare un cubo di un metro in ciascuna di queste posizioni, a livello del suolo, nella nostra applicazione AR. Il codice seguente crea oggetti ARGeospatialCreatorAnchor e assegna le relative proprietà ai valori appropriati:
for (int i = 0; i < _cityHallEastPoints.GetLength(0); i++)
{
ARGeospatialCreatorAnchor anchor =
new GameObject("City Hall " + i).AddComponent<ARGeospatialCreatorAnchor>();
anchor.Origin = origin;
anchor.AnchorManager = anchorManager;
anchor.Latitude = _cityHallEastPoints[i, 0];
anchor.Longitude = _cityHallEastPoints[i, 1];
anchor.AltitudeType = AnchorAltitudeType.Terrain;
GameObject cube = GameObject.CreatePrimitive(PrimitiveType.Cube);
cube.transform.parent = anchor.transform;
}
In questo modo vengono creati ancoraggi del terreno in ogni punto. Geospatial Creator colloca automaticamente gli ancoraggi alle coordinate mondiali di Unity appropriate, calcolandone la posizione rispetto all'oggetto ARGeospatialCreatorOrigin. Per regolare l'elevazione di un ancoraggio del terreno, imposta la proprietà Altitude in metri sopra o sotto la superficie del terreno.
In fase di esecuzione, gli ancoraggi del terreno verranno risolti a livello del suolo per l'app in esecuzione, compensati dalla proprietà Altitude. Tuttavia, nella visualizzazione della scena dell'editor, per impostazione predefinita vengono visualizzati a un'altitudine WGS84 pari a 0, non in base alla geometria della scheda 3D. Spesso non è dove vorresti vederli, quindi puoi sostituire l'altezza predefinita dell'ancora nella visualizzazione della scena di Editor impostando la proprietà UseEditorAltitudeOverride su true e specificando l'altezza in metri WGS84 utilizzando la proprietà EditorAltitudeOverride:
anchor.UseEditorAltitudeOverride = true;
anchor.EditorAltitudeOverride = -13.5; // WGS84 altitude at ground level for City Hall plaza
Queste due proprietà non hanno alcun effetto al di fuori della modalità Editor e non vengono compilate nell'app in esecuzione.
Crea un'ancora sul tetto
Per il prossimo riferimento, supponiamo che tu voglia posizionarne uno sul tetto del municipio. L'ancora può essere creata nello stesso modo, tranne per il fatto che la proprietà AltitudeType
è impostata su AnchorAltitudeType.Rooftop:
ARGeospatialCreatorAnchor cityHallRoofAnchor =
new GameObject("City Hall Roof").AddComponent<ARGeospatialCreatorAnchor>();
cityHallRoofAnchor.Origin = origin;
cityHallRoofAnchor.AnchorManager = anchorManager;
cityHallRoofAnchor.Latitude = 37.77959;
cityHallRoofAnchor.Longitude = -122.419006;
cityHallRoofAnchor.AltitudeType = AnchorAltitudeType.Rooftop;
GameObject roofCube = GameObject.CreatePrimitive(PrimitiveType.Cube);
roofCube.transform.parent = cityHallRoofAnchor.transform;
Come per gli ancoraggi del terreno, puoi perfezionare l'altitudine di un ancoraggio sul tetto nella visualizzazione della scena dell'editor utilizzando le proprietà UseEditorAltitudeOverride e EditorAltitudeOverride. Per questo esempio, l'altezza WGS84 del roof è di circa 10,7 metri.
Creare un'ancora a un'altitudine specifica
La nostra ancora finale verrà posizionata sulla sommità della cupola del municipio. Per questo riferimento, l'altitudine esatta è importante, quindi lo imposterai esplicitamente utilizzando un riferimento WGS84 anziché un riferimento al suolo o al tetto:
ARGeospatialCreatorAnchor cityHallDomeAnchor =
new GameObject("City Hall Dome").AddComponent<ARGeospatialCreatorAnchor>();
cityHallDomeAnchor.Origin = origin;
cityHallDomeAnchor.AnchorManager = anchorManager;
cityHallDomeAnchor.Latitude = 37.77928;
cityHallDomeAnchor.Longitude = -122.419241;
cityHallDomeAnchor.AltitudeType = AnchorAltitudeType.WGS84;
cityHallDomeAnchor.Altitude = 73;
GameObject domeCube = GameObject.CreatePrimitive(PrimitiveType.Cube);
domeCube.transform.parent = cityHallDomeAnchor.transform;
Non è necessario utilizzare l'override dell'altitudine solo per l'editor, poiché l'altitudine è già specificata in base a WGS84. Ovviamente, se l'altezza della geometria dei riquadri della mappa nell'editor non è corretta rispetto al mondo reale, puoi comunque utilizzare l'override dell'editor per riposizionare l'ancora nella visualizzazione della scena.
