デバイスのカメラの地理空間変換を取得する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Geospatial API を使用するようにアプリの設定を構成したら、デバイスのカメラの GAREarth.cameraGeospatialTransform を取得できます。この変換は GAREarth オブジェクトで管理され、次の情報が含まれます。
- 緯度と経度で表した位置情報
- 標高
- EUS 座標系でユーザーが向いている方向に近い向き（X+ は東、Y+ は上、Z+ は南を指す）。
ポーズを調整して精度を高める
デバイスをデフォルトの向きで正面に向けると、AR トラッキングとの自然な位置合わせにより、ピッチ（X+）とロール（Z+）の角度が正確になります。ただし、ヨー（Y+）角度は、VPS データの可用性とその場所の天候条件によって異なる場合があります。アプリで精度を調整する必要がある場合があります。
GARGeospatialTransform.orientationYawAccuracy は、GARGeospatialTransform.eastUpSouthQTarget の不確実性の半径を度単位で指定します。この値は、ローカルレベルのヨー（Y+）角度の推定値の標準偏差を示します。
次のステップ
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 UTC。"],[[["\u003cp\u003eAccess the device camera's geospatial transform to get the user's location, altitude, and orientation in the real world.\u003c/p\u003e\n"],["\u003cp\u003eAdjust the yaw angle for accuracy as it can vary due to VPS data availability and local conditions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eGARGeospatialTransform.orientationYawAccuracy\u003c/code\u003e property provides the uncertainty radius for the yaw angle estimate.\u003c/p\u003e\n"],["\u003cp\u003eUse the geospatial data to place anchors and interact with the real-world environment through your AR app.\u003c/p\u003e\n"]]],["After configuring the Geospatial API, the `GAREarth.cameraGeospatialTransform` provides location (latitude/longitude), altitude, and device orientation. Orientation uses the EUS coordinate system (X+ east, Y+ up, Z+ south). While pitch and roll are generally accurate, yaw can vary. `GARGeospatialTransform.orientationYawAccuracy` indicates yaw uncertainty. To proceed, use the data to place a Geospatial anchor, by obtaining the anchor's pose.\n"],null,["# Obtain the device camera's Geospatial transform\n\nOnce you have configured your app's settings to use the Geospatial API, you can obtain the device camera's [`GAREarth.cameraGeospatialTransform`](/ar/reference/ios/interface/GAREarth#camerageospatialtransform). This transform, managed in a [`GAREarth`](/ar/reference/ios/interface_g_a_r_earth) object, contains the following information:\n\n- Location, expressed in latitude and longitude\n- Altitude\n- An orientation approximating the direction the user is facing in the EUS coordinate system with X+ pointing east, Y+ pointing up, and Z+ pointing south\n\nAdjust the pose for accuracy\n----------------------------\n\nWhen the device is upright in the default orientation, the pitch (X+) and roll (Z+) angles tend to be precise due to a natural alignment with AR tracking. However, the yaw (Y+) angles can vary depending on VPS data availability and temporal conditions at the location. Your app may have to make adjustments for accuracy.\n\n[`GARGeospatialTransform.orientationYawAccuracy`](/ar/reference/ios/interface/GARGeospatialTransform#orientationyawaccuracy) provides the radius of uncertainty for [`GARGeospatialTransform.eastUpSouthQTarget`](/ar/reference/ios/interface_g_a_r_geospatial_transform#abd5921fc07dca0e1e2c9ce3c1c2e637b), measured in degrees. This value indicates the standard deviation of the estimate for the local-level yaw (Y+) angle.\n\nWhat's next\n-----------\n\n- Place a [Geospatial anchor](/ar/develop/ios/geospatial/anchors#wgs84_anchors) by obtaining the anchor's Geospatial pose."]]
