إذا كنت تواجه مشاكل في Geospatial API، إليك بعض الخطوات الشائعة التي يمكنك اتّخاذها.
تعذُّر نجاح تفويض مفتاح واجهة برمجة التطبيقات
إذا لم تنجح عملية التفويض باستخدام مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:
- تأكَّد من تفعيل ARCore API للمشروع الصحيح في Google Cloud.
- إذا كانت لديك أي قيود مفروضة على مفتاح واجهة برمجة التطبيقات، عليك إيقافها مؤقتًا.
استخدِم أداة تحليل ملفات APK للتأكّد من تضمين مفتاح واجهة برمجة التطبيقات في إصدار تطبيقك. يجب أن يكون في عنصر
<meta-data>في عنصر<application>في ملفAndroidManifest.xmlالخاص بتطبيقك:<meta-data android:name="com.google.android.ar.API_KEY" android:value="API_KEY"/>تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المُدرَج في بيانات اعتماد مشروعك يتطابق تمامًا مع مفتاح واجهة برمجة التطبيقات الذي يستخدمه تطبيقك، بدون مسافات أو أي أحرف أخرى.
جودة تحديد الموقع الجغرافي المكاني لا تصل أبدًا إلى القيم المتوقّعة
إذا لم تكن جودة الوضعيات التي تعرضها Geospatial API بالمستوى المتوقّع، إليك بعض الأسباب المحتملة:
- لم يتم تعيين المنطقة بواسطة مصدر رسمي لميزة "التجوّل الافتراضي" من Google.
- للتحقّق من ذلك، افتح "خرائط Google" وأدخِل ميزة "التجوّل الافتراضي" بالقرب من موضع التوطين المتوقّع. يجب أن تكون نسبة صور "التجوّل الافتراضي" إلى التجوّل الافتراضي من Google. ولا يتم أخذ المصادر الأخرى في الاعتبار في خدمة VPS.
- تقع المنطقة في منطقة محظورة.
- لا تتوفّر في المنطقة نقاط كافية للمَعالم المؤهَّلة.
- لا تستخدم خدمة VPS سوى نقاط ميزات عالية الجودة من غير المرجّح أن تتغيّر على مدار فترة زمنية طويلة. على سبيل المثال، قد تختلف الأشجار كثيرًا في مظهرها على مدار العام، لذا فهي غير مناسبة للاستخدام كنقاط ميزة.
- قد تكون المنطقة قد تغيّرت بشكل كبير بسبب أعمال البنية التحتية مقارنةً بالصور الحديثة التي تم التقاطها في "التجوّل الافتراضي" من Google.