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

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

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

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

ערכים גיאו-מרחביים תקפים רק כל עוד ArEarth.ArTrackingState הוא ArTrackingState.AR_TRACKING_STATE_TRACKING ו-ArEarth.ArEarthState הוא AR_EARTH_STATE_ENABLED. צריך להקפיד לכלול את כל הקריאות ל-geospatial API בבלוק בקרה של ArEarth.ArTrackingState.

if (ar_earth != NULL) {
  ArTrackingState earth_tracking_state = AR_TRACKING_STATE_STOPPED;
  ArTrackable_getTrackingState(ar_session, (ArTrackable*)ar_earth,
                               &earth_tracking_state);
  if (earth_tracking_state == AR_TRACKING_STATE_TRACKING) {
    ArGeospatialPose* camera_geospatial_pose = NULL;
    ArGeospatialPose_create(ar_session, &camera_geospatial_pose);
    ArEarth_getCameraGeospatialPose(ar_session, ar_earth,
                                    camera_geospatial_pose);
    // camera_geospatial_pose contains geodetic location, rotation, and
    // confidences values.
    ArGeospatialPose_destroy(camera_geospatial_pose);
  }
}

אם ArEarth.ArTrackingState לא הופך ל-ArTrackingState.AR_TRACKING_STATE_TRACKING, ArEarth.ArTrackingState יכול להיות AR_TRACKING_STATE_PAUSED או AR_TRACKING_STATE_STOPPED. אם אף אחד מהתנאים האלה לא מתקיים, מסמנים את התיבה ArEarth.ArEarthState, שמראה מצבי שגיאה אחרים שעשויים למנוע את המעקב אחרי האובייקט ArEarth.

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

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

הפונקציה ArGeospatialPose_getOrientationYawAccuracy() מספקת אומדן מדויק של זוויות הפה (Y+ ) של ArGeospatialPose מסוים. הדיוק של הסיבוב הוא מספר שמתאר את הרדיוס במעלות של רמת הסמך של האחוזון ה-68 סביב זוויות ההטיה שהוחזרו מ-ArGeospatialPose_getEastUpSouthQuaternion(). במילים אחרות, יש סיכוי של 68% שזווית ההסתה האמיתית של ArGeospatialPose מדויקת.

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

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

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