مرجع سریع کیت توسعه نرم‌افزار Google Maps برای Android

کیت توسعه نرم‌افزار 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» استفاده نکنید:

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

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

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

کیت توسعه نرم‌افزار 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: مجموعه‌داده‌ها

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

کیت توسعه نرم‌افزار Google Maps برای Android: حاشیه‌نویسی‌های Maps

کیت توسعه نرم‌افزار Google Maps برای Android: سبک‌پردازی Maps

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