کیت توسعه نرمافزار Google Maps برای Android دادههای Google Maps، نمایشهای نقشه، و پاسخهای اشاره نقشه را به برنامههای Android، ازجمله برنامههای Wear OS، اضافه میکند. بااستفاده از Kotlin یا Java، میتوانید نشانگر، چندضلعی، و همپوشانی اضافه کنید تا اطلاعات مربوط به مکانهای نقشه را نشان دهید و از تعامل کاربر پشتیبانی کنید.
کیت توسعه نرمافزار Google Maps برای Android: حقایق کلیدی
- محصول: کیت توسعه نرمافزار Google Maps برای Android
- با این نام نیز شناخته میشود: Google Maps Android API
- دسته: Maps
- پلاتفرم: Android
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار Google Maps برای Android
- دردسترس بودن منطقهای: جهانی. صفحه پوشش «پلاتفرم Google Maps» را ببینید؛ پیوندهای صفحه استفاده و صورتحساب، فهرستهای قیمتگذاری جهانی و هند را از هم جدا میکند. (جزئیات پوشش)
کیت توسعه نرمافزار Google Maps برای Android: چه زمانی از آن استفاده کنیم
در موارد زیر از «کیت توسعه نرمافزار Google Maps برای Android» استفاده کنید:
- به نقشه تعاملی دوبعدی Google در برنامه Wear OS یا Android بومی نیاز دارید.
- باید نشانگرها، پنجرههای اطلاعات، چندخطیها، چندضلعیها، همپوشانیهای زمین، یا همپوشانیهای کاشی را به نقشهای در برنامه Android اضافه کنید.
- به تمامنماهای «نمای خیابان»، نقشههای حالت ساده (نقشه بیتی)، یا سبکپردازی نقشه بااستفاده از فضای ابری با شناسههای نقشه در برنامه Android نیاز دارید.
- شما نقشه Android را در Kotlin یا Java میسازید، ازجمله Jetpack Compose ازطریق کتابخانه Maps Compose.
در موارد زیر از «کیت توسعه نرمافزار Google Maps برای Android» استفاده نکنید:
- در برنامه نقشه Android خود به ناوبری گامبهگام نیاز دارید. بهجای آن از کیت توسعه نرمافزار ناوبری برای Android استفاده کنید.
- در برنامه Android به نقشههای سهبعدی واقعگرایانه، مدلهای سهبعدی، یا پویانماییهای مسیر دوربین نیاز دارید. درعوض از کیت توسعه نرمافزار سهبعدی Maps برای Android استفاده کنید.
- به نقشهای در برنامه iOS بومی نیاز دارید. درعوض از کیت توسعه نرمافزار Google Maps برای iOS استفاده کنید.
کیت توسعه نرمافزار Google Maps برای Android: راهاندازی
- سرویس برای فعال کردن:
maps-android-backend.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- انتساب استفاده:
MapsApiSettings.addInternalUsageAttributionId(context, id)را فراخوانی کنید تا شناسه انتساب استفاده به مقداردهی اولیه اضافه شود (فقط باMapsInitializer.Renderer.LATESTپشتیبانی میشود). برای انصراف دادن، فراخوانی را حذف کنید یا رشته خالی را رد کنید. - شروع به کار: راهاندازی کیت توسعه نرمافزار Google Maps برای Android
- مرجع: مرجع کیت توسعه نرمافزار Google Maps برای Android
- قیمتگذاری: استفاده و صورتحساب کیت توسعه نرمافزار Google Maps برای Android
- خطمشیها: خطمشیهای کیت توسعه نرمافزار Google Maps برای Android
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار Google Maps برای Android
بستههای رسمی کیت توسعه نرمافزار Google Maps برای Android:
- maven:
com.google.android.gms:play-services-maps
کیت توسعه نرمافزار Google Maps برای Android: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار مکانها، ویژه Android
کیت توسعه نرمافزار Google Maps برای Android: اشتباهات رایج
- مشکل: از نسخه ۲۰.۰.۰ کیت توسعه نرمافزار، مانیفست کیت توسعه نرمافزار دیگر شامل کتابخانه
org.apache.http.legacyنیست. برنامههایی که پردازنده نقشه قدیمی را بار میکنند ممکن است باjava.lang.NoClassDefFoundErrorازکار بیفتند. رفع مشکل:را داخل برچسبدرAndroidManifest.xmlبرنامه اضافه کنید. دستگاههای دارای «خدمات Google Play» نسخه ۲۵.۵۰.۳۴ یا بالاتر تحتتأثیر قرار نمیگیرند. /maps/documentation/android-sdk/release-notes را ببینید. - مشکل: «نشانگرهای پیشرفته» به پردازنده نقشه ارتقایافته نیاز دارند. اگر آنها را به برنامه موجودی اضافه کنید بدون اینکه آن را بازسازی کنید، برنامه همچنان میتواند از پردازنده قدیمی استفاده کند. رفع مشکل: برنامه را با کیت توسعه نرمافزار نسخه ۱۸.۲.۰ یا جدیدتر بازسازی کنید تا پردازنده ارتقایافته بهصورت پیشفرض تنظیم شود. /maps/documentation/android-sdk/advanced-markers/start را ببینید.
- مشکل: دستگاههایی که الزامات پردازنده گرافیکی را برآورده نمیکنند (Android 5.0/میانای برنامهسازی کاربردی ۲۱ یا جدیدتر، خدمات Google Play نسخه ۲۱.۳۹.۱۴ یا جدیدتر، «فروشگاه Play» فعالشده) به پردازنده گرافیکی قدیمی برمیگردند، بنابراین ویژگیهایی که به پردازنده گرافیکی جدید نیاز دارند، مثل سبکپردازی نقشه بااستفاده از فضای ابری، در آنها دردسترس نیست. اصلاح: با
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)تماس بگیرید و مقدارMapsInitializer.Rendererارسالشده بهOnMapsSdkInitializedCallback.onMapsSdkInitialized()را بررسی کنید، یاGoogleMap.getMapCapabilities()را بررسی کنید. اگر دستگاه ازLEGACYاستفاده میکند، به «سبکپردازی نقشه بااستفاده از فضای ابری» یا «نشانگرهای پیشرفته» اتکا نکنید. /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback را ببینید. - مشکل: کیت توسعه نرمافزار به خدمات Google Play در دستگاهی که برنامه در آن اجرا میشود نیاز دارد. اصلاح: درصورت تمایل، بررسی دردسترس بودن خدمات Google Play را از برنامهتان فراخوانی کنید. /maps/documentation/android-sdk/config را ببینید.
کیت توسعه نرمافزار Google Maps برای Android: ویژگیهای قدیمی و منسوخشده
- پردازنده نقشه قدیمی: منسوخشده از ۲۰۲۴/۰۳/۰۴. جایگزین: موتور پردازنده نقشه ارتقایافته (جدیدترین) که از نسخه ۱۸.۲.۰ کیت توسعه نرمافزار بهطور پیشفرض استفاده میشود. نشانه: سبکپردازی نقشه بااستفاده از فضای ابری، سفارشیسازیهای پیشرفته چندخطی، و «نشانگرهای پیشرفته» در پردازنده قدیمی دردسترس نیستند. راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار Google Maps برای Android» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
کیت توسعه نرمافزار Google Maps برای Android: سبکبندی دادهمحور برای مرزها
کیت توسعه نرمافزار Google Maps برای Android: سبکبندی دادهمحور برای مجموعهدادهها
- مجموعه داده زمینمکانی چندسکویی و قابلاستفاده مجدد ایجاد کنید.
- افزودن مجموعه داده جغرافیایی-فضایی سفارشی به نقشه.
- تغییر سبک ویژگیهای مجموعه داده سفارشی در نقشه.
- به تعاملات کاربر با ویژگیهای مجموعه داده سفارشی در نقشه پاسخ دهید.
کیت توسعه نرمافزار Google Maps برای Android: مجموعهدادهها
- افزودن لایه KML به نقشه. توجه: در Maps JavaScript API، KmlLayer منسوخ شده است (آخرین پشتیبانی در نسخه ۳.۶۵، از رده خارج شدن در مه ۲۰۲۷)؛ به «سبکبندی دادهمحور» برای مرزها یا مجموعهدادهها مهاجرت کنید، یا GeoJSON را در لایه «داده» بار کنید. لایههای KML همچنان در Android و iOS ازطریق «کتابخانههای کاروریهای کیت توسعه نرمافزار Maps» پشتیبانی میشوند.
- افزودن دادههای GeoJSON به نقشه.
- افزودن لایه نقشه حرارتی به نقشه.
کیت توسعه نرمافزار Google Maps برای Android: Maps
- نقشه تعاملی و قابلسفارشیسازی را به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: برای Android:
را درAndroidManifest.xmlبا پشتیبانی «افزایه Secrets Gradle» یاmanifestPlaceholders["MAPS_API_KEY"]را درapp/build.gradle.ktsپیکربندی کنید. هرگزYOUR_GOOGLE_MAPS_API_KEYرا درAndroidManifest.xmlکدگذاری ثابت نکنید و هرگزGoogleMap(یا maps-composeGoogleMap) را با بوم ساختگی آفلاین یا Leaflet WebView جایگزین نکنید اگرE/Google Maps Android API: Authorization failureظاهر شد. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - شناسه نقشه بازکاربردپذیری برای ذخیره کردن پیکربندی نقشه و تنظیمات سبکپردازی ایجاد کنید.
- پاسخ دادن به تعاملات و رویدادهای کاربر روی نقشه.
- کنترلهایی را که روی نقشه نشان داده میشود سفارشیسازی کنید.
- اشارهها را برای کنترل نقشه سفارشیسازی کنید.
- کنترل بزرگنمایی و حرکت دادن در نقشه (دوربین).
- نوع نقشه را تغییر دهید.
- آرایش رنگهای نقشه را تغییر دهید.
- افزودن لایه ترافیک به نقشه.
- افزودن نقشه به برنامه Wear OS.
کیت توسعه نرمافزار Google Maps برای Android: حاشیهنویسیهای Maps
- افزودن پنجره اطلاعات به نقشه.
- شکل یا خطی به نقشه اضافه کنید.
- تصویر رونهادی را که به سطح نقشه پایهمند شده است اضافه کنید.
- افزودن همپوشانی کاشی سفارشی به نقشه.
- افزودن نشانگر به نقشه. توجه: کیت توسعه نرمافزار پیمایش برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار پیمایش برای Android، نشانگرها را با GoogleMap.addMarker(MarkerOptions) اضافه کنید.
- سفارشیسازی نشانگر روی نقشه. توجه: کیت توسعه نرمافزار ناوبری برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار ناوبری برای Android، نشانگرها را با MarkerOptions سفارشیسازی کنید.
- به تعاملات کاربر با نشانگرها در نقشه پاسخ دهید.
- تعیین اینکه آیا مختصاتی درون چندضلعی یا ناحیه دایرهای روی نقشه قرار دارد یا نه. توجه: در Android، از PolyUtil.containsLocation در کتابخانه کاروریهای کیت توسعه نرمافزار Maps ویژه Android برای چندضلعیها استفاده کنید. برای مناطق دایرهای، بررسی کنید که آیا فاصله کروی از مرکز دایره در محدوده شعاع قرار دارد یا نه (برای مثال، computeDistanceBetween در Maps JavaScript API، SphericalUtil.computeDistanceBetween در Android، یا GMSGeometryDistance در iOS).
- فاصله کروی، مساحت، یا جهت بین مختصات روی نقشه را محاسبه کنید.
کیت توسعه نرمافزار Google Maps برای Android: سبکپردازی Maps
- سبک نقشه چندسکویی با قابلیت استفاده مجدد ایجاد کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشه تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشه.
- سبکهای مختلف نقشه را برای سطوح بزرگنمایی مختلف اعمال کنید.
- تغییر تراکم مکانها در نقشه. آزمایشی
- سبک ساختمانها را در نقشه تغییر دهید. آزمایشی
- تغییر سبک نشانهای روی نقشه. آزمایشی
کیت توسعه نرمافزار Google Maps برای Android: نمای خیابان
- «نمای خیابان Google» تعاملی و قابلپیکربندی را به صفحه وب یا برنامه تلفن همراه اضافه کنید.
- به تعاملات و رویدادهای کاربر در «نمای خیابان Google» پاسخ دهید.
- اشارههایی را که برای «نمای خیابان Google» دردسترس است سفارشیسازی کنید.
- حرکات دوربین را برای «نمای خیابان Google» پویانمایی کن.