تبدیل Geospatial دوربین دستگاه را بدست آورید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
هنگامی که تنظیمات برنامه خود را برای استفاده از Geospatial API پیکربندی کردید، می توانید GAREarth.cameraGeospatialTransform دوربین دستگاه را دریافت کنید. این تبدیل که در یک شی GAREarth مدیریت می شود، حاوی اطلاعات زیر است:
- مکان، بیان شده در طول و عرض جغرافیایی
- ارتفاع
- جهت تقریبی جهتی که کاربر با آن روبرو است در سیستم مختصات EUS با X+ به سمت شرق، Y+ به سمت بالا و Z+ به سمت جنوب.
ژست را برای دقت تنظیم کنید
هنگامی که دستگاه در جهت پیش‌فرض عمودی است، به دلیل هم‌ترازی طبیعی با ردیابی AR، زوایای گام (X+) و رول (Z+) دقیق هستند. با این حال، زوایای انحراف (Y+) بسته به در دسترس بودن داده های VPS و شرایط زمانی در محل می تواند متفاوت باشد. برنامه شما ممکن است مجبور باشد تنظیماتی را برای دقت انجام دهد.
GARGeospatialTransform.orientationYawAccuracy شعاع عدم قطعیت را برای GARGeospatialTransform.eastUpSouthQTarget فراهم می کند که بر حسب درجه اندازه گیری می شود. این مقدار انحراف استاندارد تخمین را برای زاویه انحراف سطح محلی (Y+) نشان می دهد.
بعدش چی
- با به دست آوردن موقعیت مکانی لنگر، یک لنگر Geospatial قرار دهید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
