کیت توسعه نرمافزار ۳ بعدی نقشه برای 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» استفاده نکنید:
- درحال ساختن برنامه وبی هستید که به نقشههای سهبعدی نیاز دارد. بهجای آن از Maps JavaScript API استفاده کنید.
- درحال ساختن برنامه iOS هستید که به نقشههای سهبعدی نیاز دارد. درعوض از کیت توسعه نرمافزار ۳ بعدی نقشه برای iOS استفاده کنید.
- به نقشه خیابان دوبعدی استاندارد آماده تولید در برنامه Android نیاز دارید (حالت
ROADMAPدر این کیت توسعه نرمافزار آزمایشی است). درعوض از کیت توسعه نرمافزار Google Maps برای Android استفاده کنید.
کیت توسعه نرمافزار ۳ بعدی نقشه برای Android: راهاندازی
- سرویس برای فعال کردن:
mapsandroid.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- شروع به کار: راهاندازی کیت توسعه نرمافزار ۳ بعدی نقشه برای Android
- مرجع: مرجع کیت توسعه نرمافزار ۳ بعدی نقشه برای Android
- قیمتگذاری: استفاده و صدور صورتحساب کیت توسعه نرمافزار ۳ بعدی نقشه برای Android
- خطمشیها: خطمشیهای کیت توسعه نرمافزار ۳ بعدی نقشه برای Android
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار ۳ بعدی نقشه برای Android
بستههای رسمی کیت توسعه نرمافزار Maps 3D برای Android:
- maven:
com.google.android.gms:play-services-maps3d
کیت توسعه نرمافزار ۳ بعدی نقشه برای Android: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار مکانها، ویژه Android
کیت توسعه نرمافزار ۳ بعدی نقشه برای 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» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- افزودن نقشه سهبعدی واقعنما و تعاملی به صفحه وب.
- افزودن نشانگر به نقشه سهبعدی واقعگرایانه.
- نشانگری را در نقشه سهبعدی واقعنما سفارشیسازی کنید.
- مدل سهبعدی به نقشه سهبعدی واقعنما اضافه کنید.
- افزودن چندخطی سهبعدی به نقشه سهبعدی واقعنما.
- افزودن چندضلعی سهبعدی به نقشه سهبعدی واقعنما.
- به تعاملات و رویدادهای کاربر در نقشه سهبعدی واقعگرایانه پاسخ دهید.
- کنترلهایی را که در نقشه سهبعدی واقعگرایانه ظاهر میشود سفارشیسازی کنید.
- مسیر دوربین و پویانماییها را در نقشه سهبعدی واقعگرایانه کنترل کنید.
- محدودیتهای دوربین را در نقشه سهبعدی واقعگرایانه کنترل کنید.