دليل البدء السريع لميزة "الموقع الجغرافي المكاني" على Android

إنّ نبذة عن بدء استخدام واجهة برمجة التطبيقات ARCore Geospatial API هذه لتوضيح كيفية تشغيل نموذج تطبيق في "استوديو Android" يوضّح واجهة برمجة التطبيقات Geospatial API.

للحصول على دليل حول تطوير تطبيقك الخاص باستخدام واجهة برمجة التطبيقات Geospatial API، يُرجى الاطّلاع على دليل المطوِّرين الجغرافي المكاني لنظام التشغيل Android (Kotlin/Java) أو دليل مطوّري البرامج الجغرافية المكانية لنظام التشغيل Android NDK (C).

راجِع مقدّمة عن واجهة برمجة تطبيقات ARCore Geospatial API للحصول على مزيد من المعلومات حول واجهة برمجة التطبيقات Geospatial API.

إذا كنت جديدًا في مجال التطوير باستخدام ARCore، يُرجى الاطّلاع على البدء.

المتطلّبات

خيارات الدعم الخاصة بالجهاز

يمكنك مراجعة الأجهزة المتوافقة للحصول على قائمة كاملة بالأجهزة التي تم اعتمادها للعمل مع ARCore. بالنسبة إلى واجهة برمجة التطبيقات الجيوفضائية، تتمثل إحدى قطع الأجهزة الرئيسية المطلوبة في مقياس المغناطيسية الذي يلبي مواصفات واجهة برمجة التطبيقات الجيوفضائية. بعض مقاييس المغناطيسية لا تستوفي المواصفات، وبالتالي لا تتوافق الأجهزة التي تحتوي على مقاييس المغناطيسية الخارجة عن المواصفات.

البرامج

  • تثبيت أحدث إصدار من خدمات Google Play للواقع المعزّز على الجهاز المتوافق.

  • الإصدار 3.0 من استوديو Android أو إصدار أحدث والإصدار 7.0 (مستوى واجهة برمجة التطبيقات 24) أو الإصدارات الأحدث

  • يمكنك الحصول على حزمة ARCore SDK for Android بإحدى الطريقتَين التاليتَين:

    • يمكنك تنزيلها من GitHub واستخراجها من جهازك.

    • استنسِخ المستودع باستخدام الأمر التالي: 

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

فتح نموذج التطبيق وإعداده

يصف مشروع geospatial_java المضمن في ARCore SDK لنظام التشغيل Android الرمز الذي يستدعي واجهة برمجة التطبيقات Geospatial.

  1. في "استوديو Android"، انقر على فتح من القائمة ملف.

  2. انتقِل إلى مجلد المشروع الذي يخصّ arcore-android-sdk.

  3. افتح المجلد عيّنات، واختر المجلد geospatial_java وانقر على فتح.

إعداد مشروع على Google Cloud

لاستخدام نظام تحديد المواقع المرئي (VPS)، يجب ربط تطبيقك بمشروع على Google Cloud تم تفعيله لواجهة برمجة تطبيقات ARCore. يُرجى الاطّلاع على استخدام ARCore API على Google Cloud لإعداد التفويض. يمكنك الاختيار بين التفويض باستخدام مفتاح بدون مفتاح أو باستخدام مفتاح واجهة برمجة التطبيقات.

تشغيل نموذج التطبيق

في "استوديو Android"، شغِّل نموذج التطبيق.

من المفترض أن تتمكّن من رؤية وضع الكاميرا، بالإضافة إلى معلومات تصحيح الأخطاء التي تصف الوضع الجيوفضائي الحالي لجهازك. أثناء فحص البيئة من حولك، لاحظ أن قيم الثقة لدقة تحديد المواقع قد تتغير أثناء تحركك، إذا كنت في منطقة تتوفر فيها أقلمة VPS.

عندما يكون ARCore واثقًا من موقع جهازك واتجاهه، يمكنك وضع علامة ارتساء في موقعك الحالي باستخدام الوضع الجغرافي المكاني.

قد تكون دقة تحديد المواقع منخفضة جدًا في حال عدم توفّر معلومات عن VPS. يجب أن يكون التطبيق متصلاً بالإنترنت، وأن يكون الموقع معروفًا لـ VPS. للحصول على أفضل النتائج، شغِّل نموذج التطبيق في الخارج (وليس في الداخل) خلال ساعات النهار.

كذلك، إذا كنت في منطقة لا تتيح استخدام VPS، أو إذا لم تكن إشارات نظام تحديد المواقع العالمي (GPS) كافية، قد تحتاج إلى تعديل حدود الثقة في التطبيق لكي تتمكّن من وضع علامة ارتساء.

لضبط الحدود الدنيا:

  1. في "استوديو Android"، افتح 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. عدِّل هذه القيم حسب الحاجة. كلما ارتفعت القيمة، انخفضت الدقة.

    ويؤدي خفض الدقة إلى السماح للتطبيق بخط عرض أكبر في وضع علامة ارتساء. اطّلع على الضبط لتحسين دقة الوضع للحصول على مزيد من المعلومات.

الخطوات التالية