שימוש במבנים ובפני השטח בסביבתך ב-Android SDK (Kotlin/Java)

ממשקי ה-API של גיאומטריה של סביבת הרחוב מספקים את הגיאומטריה של פני השטח, הבניינים או מבנים אחרים בסצנה. אפשר להשתמש בגיאומטריה כדי לבצע חסימה, עיבוד או מיקום של תוכן AR באמצעות ממשקי API של בדיקת התאמה. נתוני הגיאומטריה של סביבת הרחוב מתקבלים באמצעות תמונות מ-Google Street View.

ניסיון של הדוגמה

אפליקציית הדוגמה geospatial_java מדגימה איך לקבל ולייצר גיאומטריות של סביבת הרחוב.

הגדרת Geospatial API

כדי להשתמש ב-Streetscape Geometry, צריך להגדיר את Geospatial API בפרויקט. פועלים לפי ההוראות במאמר הפעלת Geospatial API כדי להגדיר את Geospatial API.

הפעלת גיאומטריה של סביבת הרחוב

Geospatial API מקבל נתונים של גיאומטריה של סביבת הרחוב כאשר השדה GeospatialMode מוגדר לערך GeospatialMode.ENABLED והשדה StreetscapeGeometryMode מוגדר לערך StreetscapeGeometryMode.ENABLED.

Java

Config config = session.getConfig();
// Streetscape Geometry requires the Geospatial API to be enabled.
config.setGeospatialMode(Config.GeospatialMode.ENABLED);
// Enable Streetscape Geometry.
config.setStreetscapeGeometryMode(Config.StreetscapeGeometryMode.ENABLED);
session.configure(config);

Kotlin

session.configure(
  session.config.apply {
    // Streetscape Geometry requires the Geospatial API to be enabled.
    geospatialMode = Config.GeospatialMode.ENABLED
    // Enable Streetscape Geometry.
    streetscapeGeometryMode = Config.StreetscapeGeometryMode.ENABLED
  }
)

אחזור נתוני גיאומטריה של סביבת הרחוב בסשן ARCore

משתמשים ב-Session.getAllTrackables() וב-StreetscapeGeometry.class כדי לסנן את התוצאות.

Java

session.getAllTrackables(StreetscapeGeometry.class);

Kotlin

session.getAllTrackables(StreetscapeGeometry::class.java)

הסבר על StreetscapeGeometry

StreetscapeGeometry מכיל מידע על מבנה:

בניין ברמת פירוט 1

StreetscapeGeometry.Quality.BUILDING_LOD_1 מורכב משטחי בניין שנמתחים כלפי מעלה עד לחלק העליון השטוח. יכול להיות שהגובה של המבנים לא מדויק.

בניין ברמת פירוט 2

ל-StreetscapeGeometry.Quality.BUILDING_LOD_2 תהיה גיאומטריה באיכות גבוהה יותר. קירות וגגות רשת יהיו דומים יותר למבנה של הבניין. תכונות קטנות יותר, כמו תנורים או פתחי אוורור בגג, עשויות עדיין להימצא מחוץ לרשת.

הסבר על Mesh

Mesh היא רשת פוליגונים שמייצגת שחזור של פני השטח של גיאומטריה של סביבת הרחוב. כל Mesh כולל מאגר קודקודים ומאגר אינדקסים:

צירוף תוכן AR ל-StreetscapeGeometry

יש שתי דרכים לצרף תוכן AR לגיאומטריה של סביבת הרחוב:

ביצוע בדיקת היתקלות (hit-test) מול StreetscapeGeometry

אפשר להשתמש ב-Frame.hitTest() כדי לבצע בדיקת היתכנות (hit-test) לגיאומטריה של סביבת הרחוב. אם נמצאות צמתים, השדה HitResult מכיל פרטי תנוחה לגבי מיקום ההיט, וכן הפניה ל-StreetscapeGeometry שהוכה. אפשר להעביר את הגיאומטריה של סביבת הרחוב אל Trackable.createAnchor() כדי ליצור עוגן שמצורף אליה.

Java

for (HitResult hit : frame.hitTest(singleTapEvent)) {
  if (hit.getTrackable() instanceof StreetscapeGeometry) {
    Pose hitPose = hit.getHitPose();
    hit.getTrackable().createAnchor(hitPose);
  }
}

Kotlin

for (hit in frame.hitTest(singleTapEvent)) {
  if (hit.trackable is StreetscapeGeometry) {
    val hitPose = hit.hitPose
    hit.trackable.createAnchor(hitPose)
  }
}

הפעלת עומק גיאו-מרחבי

התכונה עומק גיאו-מרחבי משלבת בין גיאומטריה של סביבת הרחוב לבין קלט של חיישנים מקומיים כדי לשפר את נתוני העומק. כשהתכונה 'עומק גיאו-מרחבי' מופעלת, עומק הפלט ותמונות העומק הגולמיות משתנים כך שיכללו גיאומטריה של סביבת הרחוב בפורמט רסטר, בנוסף לעומק שנצפה באופן מקומי. כך ניתן לשפר את הדיוק של תנוחות באמצעות התכונה 'עומק'.