ב-Geospatial API, נעשה שימוש בשילוב של נתוני VPS ונתוני GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה. אפשר להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שבהם ה-GPS ברמת דיוק נמוכה, כמו מרחבים פנימיים וסביבות עירוניות צפופות, ה-API יסתמך על כיסוי ה-VPS כדי ליצור תנוחות ברמת דיוק גבוהה.
- בסביבות חיצוניות שבהן יש מעט הפרעות מהתקורה או שאין בהן הפרעות כלשהן, יכול להיות שה-Geospatial API יוכל להשתמש בנתוני המיקום הזמינים ב-GPS כדי ליצור תנוחות גיאו-מרחביות ברמת דיוק גבוהה.
אפשר לקבוע את הזמינות של VPS במיקום אופקי לפני שהסשן ב-AR מתחיל, ולהשתמש בו כדי ליצור חוויות ספציפיות יותר. לדוגמה, כדי להציג לחצן 'כניסה ל-AR' רק כששירות VPS זמין.
הפעלת ARCore API
כדי לבדוק את הזמינות של VPS צריך להפעיל את ARCore API באפליקציה.
בדיקת הזמינות של VPS באפליקציה
ניתן להשתמש ב-Geospatial API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו. אם חוויית ה-AR שלכם תלויה בכיסוי של VPS, אתם יכולים להשתמש ב-AREarthManager.CheckVpsAvailabilityAsync()
כדי לקבל VpsAvailabilityPromise
, משימה אסינכרונית שבודקת את הזמינות של שרתי ה-VPS במיקום אופקי נתון.
אחרי שמקבלים את VpsAvailabilityPromise
, אפשר לקבל את התוצאה שלו באמצעות תשאול.
סקרו את התוצאה
יש להשתמש ב-VpsAvailabilityPromise.State
כדי למצוא את המצב של InterruptiblePromise
. יש שלושה מצבים שונים:
Pending
: הפעולה עדיין לא הושלמה ולכן לא ידועה שום תוצאה.Cancelled
: הפעולה בוטלה על ידיVpsAvailabilityPromise.Cancel()
. אף פעם לא תתבצע קריאה חוזרת (callback) שרשומה.Done
: הפעולה הושלמה. משתמשים ב-VpsAvailabilityPromise.Result
כדי לקבל את התוצאה.
כדאי להמשיך לבדוק את VpsAvailabilityPromise.State
עד שהמשימה תושלם.
ביטול InterruptiblePromise
אפשר להשתמש ב-VpsAvailabilityPromise.Cancel()
כדי לנסות לבטל את InterruptiblePromise
. בגלל מקבילה בשרשור, יכול להיות שניסיון הביטול לא יצליח בפועל.
שימוש ב-Geospatial API ללא כיסוי VPS
ניתן להשתמש ב-Geospatial API גם באזורים שאין בהם כיסוי VPS. בסביבות בחוץ שבהן יש מעט הפרעות מתקורה או שאין בהן הפרעות ממבט-על, ייתכן שה-GPS יספיק כדי ליצור תנוחה ברמת דיוק גבוהה.
המאמרים הבאים
- נתוני התנוחה הגיאו-מרחבית של מצלמת המכשיר מאפשרת לקבוע את המיקום המדויק של המכשיר בעולם האמיתי.