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

کیت توسعه نرم‌افزار پیمایش برای Android ناوبری گام‌به‌گام Google Maps را با سفارشی‌سازی میانای کاربر و پیکربندی مسیر به برنامه‌های Android اضافه می‌کند. این کیت شامل لایه نقشه «کیت توسعه نرم‌افزار Maps» است، بنابراین برنامه‌هایی که از آن استفاده می‌کنند نمی‌توانند «کیت توسعه نرم‌افزار Maps برای Android» را نیز داشته باشند.

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

  • محصول: کیت توسعه نرم‌افزار پیمایش برای Android
  • همچنین با این نام شناخته می‌شود: کیت توسعه نرم‌افزار ناوبری
  • دسته: مسیرها
  • پلاتفرم: Android
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار پیمایش برای Android

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

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

  • به ناوبری گام‌به‌گام Google Maps در برنامه Android خودتان نیاز دارید تا کاربران به برنامه دیگری نروند.
  • باید میانای کاربر ناوبری را سفارشی‌سازی کنید تا با نمانام شما مطابقت داشته باشد، یا تجربه ناوبری سفارشی بسازید.
  • برای رانندگی، پیاده‌روی، دوچرخه‌سواری، یا وسایل نقلیه دوچرخ به ناوبری درون‌برنامه‌ای نیاز دارید.
  • باید مسیری را که با Routes API برنامه‌ریزی کرده‌اید با ارسال یک کد مسیر به SDK پیمایش کنید.

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

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

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

  • maven: com.google.android.libraries.navigation:navigation

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

  • مشکل: کیت توسعه نرم‌افزار ناوبری ازقبل کیت توسعه نرم‌افزار Maps را در خود دارد. ساخت‌هایی که play-services-maps را مستقیماً یا ازطریق وابستگی انتقالی وارد می‌کنند، درنهایت نسخه‌های تکراری Maps SDK را دریافت می‌کنند. اصلاح: com.google.android.gms:play-services-maps را از همه وابستگی‌ها (کنارگذاری پیکربندی‌های Gradle یا کنارگذاری‌های Maven) کنار بگذارید و هرگونه وابستگی مستقیم به Maps SDK را بردارید. /maps/documentation/navigation/android-sdk/android-studio-setup را ببینید.
  • مشکل: «کیت توسعه نرم‌افزار پیمایش» نسخه ۸.۰ و جدیدتر minAndroidGradlePluginVersion=9.0.1 را اعلام می‌کند، بنابراین ساخت‌ها با AGP قدیمی‌تر ناموفق است. رفع مشکل: قبل‌از ساختن با نسخه ۸.۰ و بالاتر، به AGP نسخه ۹.۰.۱،‏ Gradle نسخه ۹.۱.۰، و Kotlin نسخه ۲.۳.۰ ارتقا دهید. /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration را ببینید.
  • مشکل: فراخوانی مستقیم روش‌های چرخه حیات NavigationView هنگام استفاده از NavigationFragment، یا فراخوانی آن‌ها بدون ترتیب با NavigationView، منجر به خطا می‌شود. اصلاح: از NavigationFragment استفاده کنید که فراخوانی‌های چرخه حیات را مدیریت می‌کند. اگر از NavigationView استفاده می‌کنید، روش‌های چرخه حیات را به‌ترتیب دقیق بازارسال کنید. /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices را ببینید.
  • مشکل: تا زمانی که کاربر «شرایط خدمات Google Navigation» را نپذیرد، ناوبری دردسترس نیست. راه‌حل: اجازه دهید کیت توسعه نرم‌افزار اولین باری که ناوبر فراخوانده می‌شود درخواست کند، یا بااستفاده از TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog کادر گفتگو را زودتر (مثلاً درطول ثبت‌نام) نشان دهید. /maps/documentation/navigation/android-sdk/route را ببینید.

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

  • Waypoint fromLatLng() و fromPlaceId(): از کار افتاده از ۲۰۲۱-۰۵-۱۰. جایگزین: Waypoint.builder() (Waypoint.Builder). نشانه: در نسخه ۳.۰ برداشته شده است؛ فراخوانی‌ها در نسخه ۳.۰ یا جدیدتر کامپایل نمی‌شوند. راهنمای انتقال را ببینید.
  • ‫SupportNavigationFragment: منسوخ‌شده از ۲۰۲۶/۱۰/۰۱. جایگزین: NavigationFragment. نشانه: در «کیت توسعه نرم‌افزار پیمایش» نسخه ۸.۰.۰ منسوخ شده است. راهنمای انتقال را ببینید.
  • setLocationMarkerEnabled در NavigationView و SupportNavigationFragment: از ۲۰۲۳-۰۷-۰۷ از رده خارج شده است. جایگزین: GoogleMap.setMyLocationEnabled. نشانه: در نسخه ۵.۰.۰ برداشته شده است (در نسخه ۴.۱ منسوخ شده است)؛ تماس‌ها در نسخه ۵.۰ یا بالاتر کامپایل نمی‌شوند.
  • DisplayOptions showTrafficLights و showStopSigns: از ۲۰۲۶/۱۰/۰۱ از رده خارج شده است. جایگزین: جایگزینی لازم نیست؛ چراغ‌های راهنمایی و تابلوهای ایست همیشه درطول ناوبری فعال هستند. نشانه: تماس‌ها با این روش‌ها با نسخه ۸.۰.۰ کامپایل نمی‌شود.
  • مصنوع Maven com.google.android.maps:navsdk (مخزن خصوصی، نسخه ۴.x) و بارگیری بسته AAR: از ۲۰۲۳/۰۷/۰۷ از رده خارج شده است. جایگزین: com.google.android.libraries.navigation:navigation از مخزن Maven google(). نشانه: نسخه ۵.۰ و جدیدتر فقط به‌صورت com.google.android.libraries.navigation:navigation در Google Maven عرضه می‌شود؛ بسته AAR دیگر توزیع نمی‌شود. راهنمای انتقال را ببینید.

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

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

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

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

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

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