מדריך למתחילים בנושא גיאו-מרחבי ל-Android

במדריך למתחילים של ARCore Geospatial API תוכלו ללמוד איך להפעיל אפליקציה לדוגמה ב-Android Studio, שמדגימה את ה-Geospatial API.

במדריך לפיתוח אפליקציה משלכם באמצעות Geospatial API, קראו את המדריך למפתחים גיאוגרפיים ל-Android (Kotlin/Java) או את המדריך למפתחים בנושא Geospatial ל-Android NDK (C).

מידע נוסף על ה-Geospatial API זמין במאמר מבוא ל-ARCore Geospatial API.

אם זו הפעם הראשונה שאתם משתמשים ב-ARCore, כדאי לכם לעיין במאמר תחילת העבודה.

דרישות

תמיכה במכשיר

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

תוכנות

  • הגרסה האחרונה של Google Play Services למציאות רבודה שמותקנת במכשיר הנתמך.

  • Android Studio בגרסה 3.0 ואילך עם Android SDK Platform בגרסה 7.0 (רמת API 24) ואילך

  • את ARCore SDK ל-Android, אפשר לקבל באחת משתי דרכים:

    • מורידים את הקובץ מ-GitHub ומחלצים אותו מהמחשב.

    • משכפלים את המאגר באמצעות הפקודה הבאה:

      git clone https://github.com/google-ar/arcore-android-sdk.git

פתיחה והגדרה של האפליקציה לדוגמה

בפרויקט geospatial_java נכלל ב-ARCore SDK ל-Android, והוא מתאר קוד שקורא ל-Geospatial API.

  1. ב-Android Studio, בתפריט קובץ לוחצים על פתיחה.

  2. עוברים אל תיקיית הפרויקט של arcore-android-sdk.

  3. פותחים את התיקייה samples, בוחרים בתיקייה geospatial_java ולוחצים על Open.

הגדרת פרויקט ב-Google Cloud

כדי להשתמש במערכת המיקום החזותי (VPS), האפליקציה צריכה להיות משויכת לפרויקט ב-Google Cloud שמופעל בו ARCore API. במאמר שימוש ב-ARCore API ב-Google Cloud אפשר להגדיר הרשאה. אפשר לבחור הרשאה ללא מפתח או מפתח API.

הפעלת האפליקציה לדוגמה

ב-Android Studio, מפעילים את האפליקציה לדוגמה.

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

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

רמת הדיוק של המיקום עשויה להיות נמוכה מדי אם פרטי ה-VPS לא זמינים. האפליקציה צריכה להיות מחוברת לאינטרנט והמיקום צריך להיות ידוע ל-VPS. לקבלת התוצאות הטובות ביותר, הפעל את האפליקציה לדוגמה בחוץ (לא בתוך מבנה) במהלך שעות היום.

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

כך מתאימים את ערכי הסף:

  1. ב-Android Studio, פותחים את GeospatialActivity ועברו לקטע הבא:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. אפשר לשנות את הערכים האלה לפי הצורך. ככל שהערך גבוה יותר, כך רמת הדיוק נמוכה יותר.

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

השלבים הבאים