Le API Streetscape Geometry forniscono la geometria di terreni, edifici o altre strutture in una scena. La geometria può essere utilizzata per occlusione, rendering o posizionamento di contenuti AR tramite API hit-test. I dati della geometria di Streetscape sono ottenuti tramite le immagini di Google Street View.
Configurare l'API Geospatial
Per utilizzare Streetscape Geometry, devi configurare l'API Geospatial nel tuo progetto. Segui le istruzioni su come attivare l'API Geospatial per configurare l'API geospaziale.
Attiva la geometria di Streetscape
L'API Geospatial ottiene i dati di Streetscape Geometry quando ArGeospatialMode
è impostato su ArGeospatialModeEnabled
e ArStreetscapeGeometryMode
è impostato su ArStreetscapeGeometryModeEnabled
.
// Create a session config. ArConfig* ar_config = NULL; ArConfig_create(ar_session, &ar_config); // Enable the Geospatial API. ArConfig_setGeospatialMode(ar_session, ar_config, AR_GEOSPATIAL_MODE_ENABLED); CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); // Enable Streetscape Geometry. ArConfig_setStreetscapeGeometryMode(ar_session, ar_config, AR_STREETSCAPE_GEOMETRY_MODE_ENABLED); CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); // Release config resources. ArConfig_destroy(ar_config);
Ottenere la geometria Streetscape in una sessione ARCore
UtilizzaArSession_getAllTrackables()
e AR_TRACKABLE_STREETSCAPE_GEOMETRY
per filtrare i risultati.
ArTrackableList* trackable_list = NULL; ArTrackableList_create(ar_session, &trackable_list); ArSession_getAllTrackables(ar_session, AR_TRACKABLE_STREETSCAPE_GEOMETRY, trackable_list);
Informazioni su ArStreetscapeGeometry
ArStreetscapeGeometry
contiene informazioni su un edificio:
-
ArStreetscapeGeometry_getType()
Identifica StreetscapeGeometry come terreno o un edificio. -
ArStreetscapeGeometry_acquireMesh()
Crea un poligonoArMesh
corrispondente al terreno o all'edificio in questione. -
ArStreetscapeGeometry_getMeshPose()
Descrive l'origine della geometria. Tutti i punti inArMesh
devono essere trasformati daArStreetscapeGeometry_getMeshPose()
. -
ArStreetscapeGeometry_getQuality()
Fornisce la qualità dei dati mesh. I livelli di dettaglio sono descritti nello standard CityGML 2.0.
Edificio livello 1
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_1
è costituito da impronte di edifici estruse verso l'alto fino a formare una parte superiore piana. L'altezza degli edifici potrebbe non essere precisa.
Edificio livello 2
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_2
avrà una geometria con fedeltà più alta. Le pareti e i tetti in retina si adattano meglio alla forma dell'edificio. Elementi più piccoli come camini o prese d'aria sul tetto potrebbero comunque penetrare all'esterno della rete.
Informazioni su ArMesh
ArMesh
è una rete poligonale che rappresenta una ricostruzione della superficie della geometria di Street View.
Ogni ArMesh
include un buffer di vertex e un buffer di indice:
ArMesh_getVertexListSize()
Recupera il numero di vertici in questa mesh.ArMesh_getVertexList()
Ottenere le posizioni concatenate dei vertici della mesh, in coordinate relative aArStreetscapeGeometry_getMeshPose()
.ArMesh_getIndexListSize()
Recupera il numero di indici in questa mesh.ArMesh_getIndexList()
Recupera gli indici dei vertici che compongono una faccia.
Allegare contenuti AR a una ArStreetscapeGeometry
Esistono due modi per allegare contenuti AR a Streetscape Geometry:
- Attiva Profondità geospaziale e utilizza un hit test di profondità. Questo è il metodo consigliato e più semplice.
- Utilizza
ArTrackable_acquireNewAnchor()
per creare un ancoraggio in una determinata posizione associata a unArStreetscapeGeometry
. Questo ancoraggio erediterà il proprio stato di monitoraggio dall'elemento principaleArStreetscapeGeometry
.
Eseguire un hit-test contro ArStreetscapeGeometry
ArFrame_hitTest
può essere utilizzato per eseguire un test di hit rispetto alla geometria di Streetscape. Se vengono individuati degli incroci, ArHitResult
contiene informazioni sulla posa relativamente alla posizione dell'hit, oltre a un riferimento alla ArStreetscapeGeometry
che è stata rilevata. La geometria di Streetscape può essere passata a ArTrackable_acquireNewAnchor()
per creare un ancoraggio collegato.
ArHitResultList *hit_result_list = NULL; ArHitResult *hit_result = NULL; ArHitResultList_create(ar_session, &hit_result_list); ArHitResult_create(ar_session, &hit_result); ArFrame_hitTestRay(ar_session, ar_frame, origin, direction, hit_result_list); ArHitResultList_getItem(ar_session, hit_result_list, 0, hit_result); ArAnchor *out_anchor = NULL; ArStatus status = ArHitResult_acquireNewAnchor(ar_session, hit_result, &out_anchor); CHECK(status == AR_SUCCESS);
Attiva profondità geospaziale
La profondità geospaziale combina la geometria di paesaggi urbani con input dei sensori locali per migliorare i dati sulla profondità. Quando la funzionalità Profondità geospaziale è attivata, le immagini di profondità di output e di profondità non elaborate vengono modificate per includere la geometria di Streetscape rasterizzata oltre alla profondità osservata localmente. Ciò può migliorare la precisione delle pose usando la profondità.