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

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

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

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

إذا كنت حديث العهد بتطوير التطبيقات باستخدام ARCore، يمكنك الاطّلاع على البدء.

المتطلبات

دعم الجهاز

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

البرامج

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

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

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

    ويسمح خفض الدقة للتطبيق بالعرض بشكل أكبر في وضع علامة ارتساء. عرض اضبط درجة الدقة في الوضعية لمزيد من المعلومات.

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