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

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

  • מיקום, שמוצג לפי קו רוחב וקו אורך
  • גובה
  • כיוון שמשויך בערך לכיוון שאליו פונה המשתמש במערכת הקואורדינטות EUS, כאשר 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 מעלות.

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