Streetscape Geometry API は、シーン内の地形、建物、その他の構造物のジオメトリを提供します。ジオメトリは、オクルージョン、レンダリング、ヒットテスト API を介した AR コンテンツの配置に使用できます。ストリートビュー ジオメトリ データは、Google ストリートビュー画像から取得したものです。
Geospatial API を設定する
Streetscape Geometry を使用するには、プロジェクトに Geospatial API を設定する必要があります。 Geospatial API を有効にするの手順に沿って、Geospatial API を設定します。
ストリートビュー ジオメトリを有効にする
Geospatial API は、ArGeospatialMode
が ArGeospatialModeEnabled
に設定され、ArStreetscapeGeometryMode
が ArStreetscapeGeometryModeEnabled
に設定されている場合に、Streetscape Geometry データを取得します。
// 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);
ARCore セッションでストリートビュー ジオメトリを取得する
ArSession_getAllTrackables()
と AR_TRACKABLE_STREETSCAPE_GEOMETRY
を使用して、結果をフィルタします。
ArTrackableList* trackable_list = NULL; ArTrackableList_create(ar_session, &trackable_list); ArSession_getAllTrackables(ar_session, AR_TRACKABLE_STREETSCAPE_GEOMETRY, trackable_list);
ArStreetscapeGeometry
について理解する
ArStreetscapeGeometry
には、建物に関する情報が含まれています。
-
ArStreetscapeGeometry_getType()
StreetscapeGeometry を地形または建物として識別します。 -
ArStreetscapeGeometry_acquireMesh()
この地形や建物に対応するポリゴンArMesh
を取得します。 -
ArStreetscapeGeometry_getMeshPose()
ジオメトリの原点を説明します。ArMesh
内のすべてのポイントはArStreetscapeGeometry_getMeshPose()
で変換する必要があります。 -
ArStreetscapeGeometry_getQuality()
メッシュデータの品質を提供します。詳細レベルは CityGML 2.0 規格で説明されています。
LOD 1 のビルド
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_1
は、平らな上部まで上向きに押し出された建物のフットプリントで構成されます。建物の高さは正確でない可能性があります。
LOD 2 のビルド
AR_STREETSCAPE_GEOMETRY_QUALITY_BUILDING_LOD_2
のジオメトリの忠実度が高まります。メッシュの壁や屋根は、建物の形状により近くなります。煙突や屋根の通気口などの小さい対象物は、メッシュの外側に突く可能性があります。
ArMesh
について理解する
ArMesh
は「ストリートビュー ジオメトリ」の表面の再構築を表すポリゴン メッシュです。
各 ArMesh
には、頂点バッファとインデックス バッファが含まれます。
ArMesh_getVertexListSize()
このメッシュ内の頂点の数を取得します。ArMesh_getVertexList()
メッシュの頂点の連結位置を、ArStreetscapeGeometry_getMeshPose()
。ArMesh_getIndexListSize()
このメッシュ内のインデックスの数を取得します。ArMesh_getIndexList()
面を構成する頂点のインデックスを取得します。
AR コンテンツを ArStreetscapeGeometry
にアタッチする
AR コンテンツを Streetscape Geometry にアタッチするには、次の 2 つの方法があります。
- [Geospatial Depth] を有効にし、Depth ヒットテストを使用します。これは推奨される簡単な方法です。
ArTrackable_acquireNewAnchor()
を使用して、ArStreetscapeGeometry
に関連付けられる特定のポーズにアンカーを作成します。このアンカーは、親ArStreetscapeGeometry
からトラッキング状態を継承します。
ArStreetscapeGeometry
に対してヒットテストを行う
ArFrame_hitTest
を使用すると、ストリートビュー ジオメトリのヒットテストを行うことができます。交差点が見つかった場合、ArHitResult
にはヒットした場所に関するポーズ情報と、ヒットした ArStreetscapeGeometry
への参照が含まれます。このストリートビュー ジオメトリを ArTrackable_acquireNewAnchor()
に渡して、このジオメトリに関連付けるアンカーを作成できます。
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);
Geospatial Depth を有効にする
Geospatial Depth: ストリートビューのジオメトリを組み合わせたもの ローカル センサー入力を使用して、奥行きデータを強化します。Geospatial Depth が有効な場合 出力される深度と未加工の奥行き画像は、ローカルで観測された奥行きに加えて、ラスタライズされたストリートビュー ジオメトリを含むように修正されます。 これにより、奥行きを使用したポーズの精度が向上する可能性があります。