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

אחרי שמגדירים את ההגדרות של האפליקציה לשימוש ב-Geospatial API, אפשר להפעיל את Earth.getCameraGeospatialPose() כדי לקבל GeospatialPose שמתאר את המיקום הגיאו-מרחבי של המכשיר למצלמה בפריים האחרון. התנוחה הזו, שמנוהלת באובייקט Earth, מכילה את הפרטים הבאים:

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

בדיקת סטטוס המעקב

ערכים גיאו-מרחביים תקפים רק כאשר הערך של Earth.TrackingState הוא TrackingState.TRACKING. חשוב לתחום את כל הקריאות ל-Geospatial API בבלוק בקרה מסוג Earth.TrackingState.

JavaKotlin
if (earth != null && earth.getTrackingState() == TrackingState.TRACKING) {
  GeospatialPose cameraGeospatialPose = earth.getCameraGeospatialPose();
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}
 
if (earth.trackingState == TrackingState.TRACKING) {
  val cameraGeospatialPose = earth.cameraGeospatialPose
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}

אם Earth.TrackingState לא הופך ל-TrackingState.TRACKING, הערך של Earth.TrackingState עשוי להיות TrackingState.PAUSED או TrackingState.STOPPED. אם אף אחד מהתנאים האלה לא מתקיים, בודקים את השדה Earth.Earthstate, שבו מוצגים מצבי שגיאה אחרים שעשויים למנוע את המעקב אחרי האובייקט Earth.

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

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

GeospatialPose.getOrientationYawAccuracy() מספק הערכת דיוק לזוויות ההטיה (Y+) של GeospatialPose מסוים. הדיוק של כיוון הנטייה (yaw) הוא מספר שמתאר את הרדיוס, במעלות, של רמת האמון ב-68% סביב זוויות הנטייה (yaw) שמוחזרות מ-GeospatialPose.getEastUpSouthQuaternion(). במילים אחרות, יש סיכוי של 68% שזווית הנטייה האמיתית של GeospatialPose מדויקת.

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

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