קבלת המיקום הגיאו-מרחבי של מצלמת המכשיר

אחרי שקובעים את הגדרות האפליקציה לשימוש ב-גיאו-מרחבי API, אפשר לקבל את AREarthManager.CameraGeospatialPose של מצלמת המכשיר. התנוחה הזו, שמנוהלת באובייקט AREarthManager, מכילה את המידע הבא:

• מיקום, שמוצג לפי קו רוחב וקו אורך
• גובה
• כיוון שמעריך את הכיוון שאליו המשתמש פונה במערכת הקואורדינטות של האיחוד האירופי, כאשר X+ פונה מזרחה, Y+ מצביע למעלה ו-Z+ מצביע דרומה.

בדיקת מצב המעקב

ערכים גיאו-מרחביים תקפים רק כל עוד AREarthManager.EarthTrackingState הוא TrackingState.Tracking. חשוב לתחום את כל הקריאות ל-Geospatial API בבלוק בקרה מסוג AREarthManager.EarthTrackingState.

var earthTrackingState = EarthManager.EarthTrackingState;
if (earthTrackingState == TrackingState.Tracking)
{
  // camera_geospatial_pose contains geodetic location, rotation, and
  // confidences values.
  var cameraGeospatialPose = EarthManager.CameraGeospatialPose;
}

אם AREarthManager.EarthTrackingState לא הופך ל-TrackingState.Tracking, הערך של AREarthManager.EarthTrackingState עשוי להיות TrackingState.Limited או TrackingState.None. אם אף אחד מהתנאים האלה לא מתקיים, בודקים את השדה TrackingState.EarthTrackingState, שבו מוצגים מצבי שגיאה אחרים שעשויים למנוע את המעקב אחרי האובייקט AREarthManager.

שינוי התנוחה כדי לשפר את הדיוק

כשהמכשיר זקוף בכיוון ברירת המחדל, זוויות ההטיה (X+) והרוטציה (Z+) הן בדרך כלל מדויקות בגלל ההתאמה הטבעית למעקב AR. עם זאת, זוויות הפה (Y+ ) עשויות להשתנות בהתאם לזמינות הנתונים של VPS ולתנאי הזמן במיקום. יכול להיות שתצטרכו לבצע שינויים באפליקציה כדי לשפר את הדיוק.

השדה GeospatialPose.OrientationYawAccuracy מספק אומדן של הדיוק של זוויות ההטיה (Y+) עבור AREarthManager.CameraGeospatialPose מסוים. הדיוק של הסיבוב הוא מספר שמתאר את הרדיוס במעלות של רמת הסמך של האחוזון ה-68 סביב זוויות ההטיה ב-GeospatialPose.EunRotation. במילים אחרות, יש סיכוי של 68% שזווית ההסתה האמיתית של AREarthManager.CameraGeospatialPose מדויקת במספר המעלות שמוחזרת על ידי GeospatialPose.OrientationYawAccuracy.

ככל שהערך גבוה יותר, כך רמת הדיוק נמוכה יותר. לדוגמה, אם זווית ההטיה המשוערת היא 60 מעלות ודיוק ההטיה הוא 10 מעלות, יש 68% סבירות שזווית ההטיה האמיתית היא בין 50 ל-70 מעלות.

המאמרים הבאים

• מציבים עוגן גיאו-מרחבי באמצעות המיקום של העוגן מבחינה גיאו-מרחבית.