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

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

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

לצפייה מידע נוסף מבוא ל-ARCore Geospatial API מידע על ה-API הגיאו-מרחבי.

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

דרישות

תמיכה במכשיר

לרשימת המכשירים המלאה אפשר לעיין בקטע מכשירים נתמכים אושרו לעבוד עם ARCore. עבור ה-API הגיאו-מרחבי, חלקים מהחומרה הנדרשים הם מגנטומטר שעומד ב-Geospatial 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 ולאחר מכן לוחצים על פתיחה.

הגדרת פרויקט ב-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. משנים את הערכים האלה לפי הצורך. ככל שהערך גבוה יותר, כך הדיוק נמוך.

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

השלבים הבאים