عیب‌یابی کردن مشکلات Geospatial API

دستگاه‌های XR واجدشرایط
این راهنمایی به شما کمک می‌کند برای این نوع دستگاه‌های واقعیت گسترده تجربه بسازید.
عینک واقعیت گسترده سیمی
عینک
نمایشگردار و صوتی

اگر با Geospatial API مشکل دارید، در اینجا چند مرحله رایج برای انجام دادن وجود دارد.

مجوز کلید میانای برنامه‌سازی کاربردی هرگز موفق نمی‌شود

اگر مجوز کلید 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 Maps را باز کنید و در نزدیکی موقعیت محلی‌سازی موردانتظار، وارد «نمای خیابان» شوید. انتساب تصاویر «نمای خیابان» باید نمای خیابان Google باشد. منابع دیگر برای VPS درنظر گرفته نمی‌شوند.
  • منطقه در ناحیه محدودشده‌ای قرار دارد.
  • این منطقه نقاط عارضه واجدشرایط کافی ندارد.
    • VPS فقط از نقاط مشخصه باکیفیت بالا استفاده می‌کند که احتمال تغییر آن‌ها در طولانی‌مدت کم است. برای مثال، ظاهر درختان ممکن است درطول سال تغییرات زیادی داشته باشد، بنابراین برای استفاده به‌عنوان نقطه مشخصه مناسب نیستند.
    • ممکن است این منطقه به‌دلیل کارهای زیرساختی نسبت به تصاویر اخیر «نمای خیابان Google» تغییرات قابل‌توجهی کرده باشد.