Nhận được sự biến đổi Không gian địa lý của máy ảnh của thiết bị
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Sau khi định cấu hình chế độ cài đặt của ứng dụng để sử dụng API không gian địa lý, bạn có thể lấy GAREarth.cameraGeospatialTransform của máy ảnh thiết bị. Biến đổi này, được quản lý trong đối tượng GAREarth, chứa các thông tin sau:
- Vị trí, được biểu thị bằng vĩ độ và kinh độ
- Cao độ
- Hướng gần đúng với hướng người dùng đang đối mặt trong hệ toạ độ EUS, trong đó X+ chỉ về hướng đông, Y+ chỉ lên trên và Z+ chỉ về hướng nam
Điều chỉnh tư thế để đảm bảo tính chính xác
Khi thiết bị đứng thẳng theo hướng mặc định, các góc độ nghiêng (X+) và nghiêng (Z+) có xu hướng chính xác do được căn chỉnh tự nhiên với tính năng theo dõi AR. Tuy nhiên, các góc xoay ngang (Y+) có thể thay đổi tuỳ thuộc vào tình trạng sẵn có của dữ liệu VPS và điều kiện thời gian tại vị trí đó. Ứng dụng của bạn có thể phải điều chỉnh để đảm bảo độ chính xác.
GARGeospatialTransform.orientationYawAccuracy cung cấp bán kính không chắc chắn cho GARGeospatialTransform.eastUpSouthQTarget, được đo bằng độ. Giá trị này cho biết độ lệch chuẩn của giá trị ước tính cho góc yaw (Y+) ở cấp địa phương.
Bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
