مرجع سریع کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android

کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android به برنامه‌های Android امکان می‌دهد نقشه‌های سه‌بعدی تعاملی ساخته‌شده از تصاویر سه‌بعدی Google را نمایش دهند. این API نشانگرها، پنجره‌های بازشو، چندخطی‌ها، چندضلعی‌ها، مدل‌های سه‌بعدی glTF، پویانمایی‌های مسیر دوربین، و کنترل‌هایی برای تعامل کاربر و حرکت دوربین ارائه می‌دهد.

کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android: حقایق کلیدی

  • محصول: کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android
  • با این نام نیز شناخته می‌شود: کیت توسعه نرم‌افزار Android سه‌بعدی Maps
  • دسته: Maps
  • پلاتفرم: Android
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار سه‌بعدی Maps برای Android
  • دردسترس بودن منطقه‌ای: محدود. دردسترس بودن بسته به کشور و منطقه متفاوت است؛ ستون Maps 3D (جاوااسکریپت، Android،‏ iOS) را در صفحه پوشش Google Maps Platform ببینید. (جزئیات پوشش)

کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android: زمان استفاده از آن

در شرایط زیر از «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android» استفاده کنید:

  • باید نقشه سه‌بعدی تعاملی و واقع‌گرایانه‌ای از مکان‌های دنیای واقعی را در برنامه Android نشان دهید.
  • به نشانگرها، پاپ‌اورها، چندخطی‌ها، چندضلعی‌ها، یا مدل‌های سه‌بعدی glTF نیاز دارید که روی نقشه سه‌بعدی در برنامه Android قرار داده شده باشند.
  • به پویانمایی‌های ازپیش تعریف‌شده دوربین (پرواز به، پرواز در اطراف) نیاز دارید که کاربران را بین نقاط روی نقشه سه‌بعدی راهنمایی کند.
  • باید کنترل کنید که کاربران از کدام حرکات دوربین و کنترل‌های میانای کاربر می‌توانند در نقشه سه‌بعدی در برنامه Android استفاده کنند.

در موارد زیر از «کیت توسعه نرم‌افزار Maps 3D ویژه Android» استفاده نکنید:

کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android: راه‌اندازی

بسته‌های رسمی کیت توسعه نرم‌افزار Maps 3D برای Android:

  • maven: com.google.android.gms:play-services-maps3d

کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android: اشتباهات رایج

  • مشکل: اگر حالت نقشه هنگام بار شدن نقشه مشخص نشده باشد، نقشه بار نمی‌شود. اصلاح: همیشه یک Map3DMode (SATELLITE، HYBRID، یا ROADMAP) در XML چیدمان (map3d:mapMode) یا با setMapMode/Map3DInitConfig تنظیم کنید. /maps/documentation/maps-3d/android-sdk/map-modes را ببینید.
  • مشکل: شنوندگان کلیک (کلیک‌های نشانگر و نقشه) در رشته میانای کاربر اصلی اجرا نمی‌شوند، بنابراین به‌روزرسانی‌های مستقیم میانای کاربر از گرداننده ناموفق است. اصلاح: قبل‌از به‌روزرسانی میانای کاربر، به رشته اصلی بروید، مثلاً با lifecycleScope.launch(Dispatchers.Main). /maps/documentation/maps-3d/android-sdk/add-a-marker را ببینید.
  • مشکل: وضعیت نقشه در Map3DView نمونه هم‌رسانی می‌شود، بنابراین نشانگرها، هم‌پوشانی‌ها، و موقعیت دوربین از نمای قدیمی به نمای جدید منتقل می‌شود. اصلاح: فقط یک Map3DView فعال نگه دارید؛ onDestroy() را در نمونه قدیمی فراخوانی کنید و نشانگرها و هم‌پوشانی‌ها را به‌صورت دستی پاک کنید و دوربین را ازطریق GoogleMap3D بازنشانی کنید. /maps/documentation/maps-3d/android-sdk/add-a-3d-map را ببینید.
  • مشکل: به‌طور پیش‌فرض، تک‌ضرب زدن روی نقطه جالب نقشه پایه، ابزاره میانای کاربر «اماکن» را نشان می‌دهد که به وابستگی Places SDK نیز نیاز دارد. اصلاح: وابستگی «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» را اضافه کنید و اگر ابزاره پیش‌فرض را نمی‌خواهید، true را از onMap3DClick در OnMap3DClickListener برگردانید تا ابزاره پیش‌فرض را سرکوب کنید. /maps/documentation/maps-3d/android-sdk/points-of-interest را ببینید.

کارهایی که می‌توانید با «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android» انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.