ב-Geo-Space API נעשה שימוש בשילוב של נתוני VPS ו-GPS כדי ליצור מיקומים גיאו-מרחביים ברמת דיוק גבוהה. ניתן להשתמש ב-API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו:
- באזורים שרמת הדיוק של ה-GPS שלהם נמוכה, כמו אזורים סגורים וסביבות עירוניות צפופות, ה-API יסתמך על כיסוי VPS כדי ליצור תנוחות ברמת דיוק גבוהה.
- בסביבות חיצוניות שבהן יש מעט הפרעות ממבט על, או שאין בהן הפרעות מצופה, יכול להיות שה-API הגיאו-מרחבי יוכל להשתמש בנתוני המיקום הזמינים לפי ה-GPS כדי ליצור מיקומים גיאו-מרחביים ברמת דיוק גבוהה.
אפשר לקבוע את הזמינות של VPS במיקום אופקי נתון לפני שסשן ה-AR מתחיל, ולהשתמש בו כדי ליצור חוויות ספציפיות יותר. לדוגמה, כדי להציג 'Enter AR' רק כאשר VPS זמין.
הפעלה של ARCore API
כדי לבדוק את הזמינות של VPS, האפליקציה צריכה להפעיל את ARCore API.
אחרי שמפעילים את ARCore API, אפשר לבדוק את הזמינות של VPS בלי:
- מכשיר נוכחי
Session
(לפני התקשרות ל-Session.resume()
). - הגדרה של
GeospatialMode
.
בודקים את הזמינות של VPS באפליקציה
ניתן להשתמש ב-Geospatial API בכל מקום שבו המכשיר יכול לקבוע את המיקום שלו. אם חוויית ה-AR מבוססת על הכיסוי של VPS, אתם יכולים להשתמש ב-Session.checkVpsAvailabilityAsync()
כדי לקבל משימה אסינכרונית VpsAvailabilityFuture
, שבודקת את הזמינות של VPS במיקום אופקי נתון.
אחרי שמקבלים את ה-VpsAvailabilityFuture
, אפשר לקבל את התוצאה שלו באמצעות סקרים או התקשרות חזרה.
סקר את התוצאה
צריך להשתמש ב-Future.getState()
כדי לקבל את המצב של Future
. יש שלושה מצבים שונים:
PENDING
: הפעולה עדיין לא הושלמה ולכן אין תוצאה ידועה.CANCELLED
: הפעולה בוטלה על ידיFuture.cancel()
. אף פעם לא תתבצע קריאה חוזרת (callback) רשום.DONE
: הפעולה הושלמה. כדי לקבל את התוצאה, משתמשים בפונקציהVpsAvailabilityFuture.getResult()
.
אפשר להמשיך לבדוק את Future.getState()
עד שהמשימה תושלם.
Java
// Obtain a VpsAvailabilityFuture and store it somewhere. VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null); // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.getState() == FutureState.DONE) { switch (future.getResult()) { case AVAILABLE: // VPS is available at this location. break; case UNAVAILABLE: // VPS is unavailable at this location. break; case ERROR_NETWORK_CONNECTION: // The external service could not be reached due to a network connection error. break; // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ... } }
Kotlin
// Obtain a VpsAvailabilityFuture and store it somewhere. val future = session.checkVpsAvailabilityAsync(latitude, longitude, null) // Poll VpsAvailabilityFuture later, for example, in a render loop. if (future.state == FutureState.DONE) { when (future.result) { VpsAvailability.AVAILABLE -> { // VPS is available at this location. } VpsAvailability.UNAVAILABLE -> { // VPS is unavailable at this location. } VpsAvailability.ERROR_NETWORK_CONNECTION -> { // The external service could not be reached due to a network connection error. } else -> { TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...") } } }
קבלת התוצאה באמצעות קריאה חוזרת (callback)
אפשר גם לקבל את התוצאה של Future
באמצעות התקשרות חזרה. משתמשים ב-Session.checkVpsAvailabilityAsync()
ומציינים callback
. תתבצע קריאה אל callback
הזה בשרשור הראשי זמן קצר אחרי שהמצב של Future
ישתנה DONE
.
Java
session.checkVpsAvailabilityAsync( latitude, longitude, result -> { // Callback is called on the Main thread. switch (result) { // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. } });
Kotlin
session.checkVpsAvailabilityAsync(latitude, longitude) { result -> // Callback is called on the Main thread. // Handle the VpsAvailability result as shown above. // For example, show UI that enables your AR view. TODO("Handle VpsAvailability " + result) }
ביטול של Future
אפשר ללחוץ על Future.cancel()
כדי לנסות לבטל את Future
. בגלל שרשורים מקבילים, יכול להיות שניסיון הביטול לא יצליח.
הפונקציה Future.cancel()
מחזירה true
אם הניסיון הסתיים בהצלחה. אחרת, הפונקציה false
.
שימוש ב-Geo-patial API ללא כיסוי VPS
אפשר להשתמש ב-Geospatial API גם באזורים שאין להם כיסוי של VPS. בסביבות חיצוניות שבהן אין הפרעות מעל הרצפה או שאין בהן הפרעות מצד ה-GPS, ייתכן שה-GPS מספיק כדי ליצור תנוחה ברמת דיוק גבוהה.
המאמרים הבאים
- להשיג את המיקום הגיאו-מרחבי של מצלמת המכשיר כדי לקבוע את המיקום המדויק של המכשיר של המשתמש בעולם האמיתי.