کیت توسعه نرمافزار پیمایش برای Android ناوبری گامبهگام Google Maps را با سفارشیسازی میانای کاربر و پیکربندی مسیر به برنامههای Android اضافه میکند. این کیت شامل لایه نقشه «کیت توسعه نرمافزار Maps» است، بنابراین برنامههایی که از آن استفاده میکنند نمیتوانند «کیت توسعه نرمافزار Maps برای Android» را نیز داشته باشند.
کیت توسعه نرمافزار پیمایش برای Android: حقایق کلیدی
- محصول: کیت توسعه نرمافزار پیمایش برای Android
- همچنین با این نام شناخته میشود: کیت توسعه نرمافزار ناوبری
- دسته: مسیرها
- پلاتفرم: Android
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار پیمایش برای Android
کیت توسعه نرمافزار پیمایش برای Android: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار پیمایش» برای Android استفاده کنید:
- به ناوبری گامبهگام Google Maps در برنامه Android خودتان نیاز دارید تا کاربران به برنامه دیگری نروند.
- باید میانای کاربر ناوبری را سفارشیسازی کنید تا با نمانام شما مطابقت داشته باشد، یا تجربه ناوبری سفارشی بسازید.
- برای رانندگی، پیادهروی، دوچرخهسواری، یا وسایل نقلیه دوچرخ به ناوبری درونبرنامهای نیاز دارید.
- باید مسیری را که با Routes API برنامهریزی کردهاید با ارسال یک کد مسیر به SDK پیمایش کنید.
در موارد زیر از «کیت توسعه نرمافزار ناوبری برای Android» استفاده نکنید:
- درحال ساختن برنامه برای iOS هستید. درعوض از کیت توسعه نرمافزار ناوبری برای iOS استفاده کنید.
- درحال ساختن برنامه چندسکویی با Flutter یا React Native هستید. درعوض از Google Navigation برای Flutter و React Native استفاده کنید.
- به محاسبه زمان تخمینی رسیدن، مسیر، یا کد مسیر سمت سرور نیاز دارید، نه راهنمایی گامبهگام درونبرنامه. درعوض از Routes API استفاده کنید.
کیت توسعه نرمافزار پیمایش برای Android: راهاندازی
- سرویس برای فعال کردن:
navigationsdk.googleapis.com - اصالتسنجی: کلید میانای برنامهسازی کاربردی
- انتساب استفاده:
MapsApiSettings.addInternalUsageAttributionId(context, id)را فراخوانی کنید تا شناسه انتساب استفاده به مقداردهی اولیه اضافه شود. برای انصراف دادن، تماس را حذف کنید یا رشته خالی ارسال کنید. - شروع به کار: راهاندازی کیت توسعه نرمافزار پیمایش برای Android
- مرجع: مرجع کیت توسعه نرمافزار ناوبری برای Android
- قیمتگذاری: استفاده و صدور صورتحساب کیت توسعه نرمافزار پیمایش برای Android
- خطمشیها: خطمشیهای کیت توسعه نرمافزار ناوبری برای Android
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار پیمایش برای Android
بستههای رسمی کیت توسعه نرمافزار پیمایش برای Android:
- maven:
com.google.android.libraries.navigation:navigation
کیت توسعه نرمافزار پیمایش برای Android: محصولات مرتبط
- اغلب با این موارد استفاده میشود: Routes API، Driver SDK for Android
کیت توسعه نرمافزار پیمایش برای 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: ویژگیهای قدیمی و منسوخشده
WaypointfromLatLng()وfromPlaceId(): از کار افتاده از ۲۰۲۱-۰۵-۱۰. جایگزین:Waypoint.builder()(Waypoint.Builder). نشانه: در نسخه ۳.۰ برداشته شده است؛ فراخوانیها در نسخه ۳.۰ یا جدیدتر کامپایل نمیشوند. راهنمای انتقال را ببینید.-
SupportNavigationFragment: منسوخشده از ۲۰۲۶/۱۰/۰۱. جایگزین:NavigationFragment. نشانه: در «کیت توسعه نرمافزار پیمایش» نسخه ۸.۰.۰ منسوخ شده است. راهنمای انتقال را ببینید. setLocationMarkerEnabledدرNavigationViewوSupportNavigationFragment: از ۲۰۲۳-۰۷-۰۷ از رده خارج شده است. جایگزین:GoogleMap.setMyLocationEnabled. نشانه: در نسخه ۵.۰.۰ برداشته شده است (در نسخه ۴.۱ منسوخ شده است)؛ تماسها در نسخه ۵.۰ یا بالاتر کامپایل نمیشوند.DisplayOptionsshowTrafficLightsوshowStopSigns: از ۲۰۲۶/۱۰/۰۱ از رده خارج شده است. جایگزین: جایگزینی لازم نیست؛ چراغهای راهنمایی و تابلوهای ایست همیشه درطول ناوبری فعال هستند. نشانه: تماسها با این روشها با نسخه ۸.۰.۰ کامپایل نمیشود.- مصنوع Maven
com.google.android.maps:navsdk(مخزن خصوصی، نسخه ۴.x) و بارگیری بسته AAR: از ۲۰۲۳/۰۷/۰۷ از رده خارج شده است. جایگزین:com.google.android.libraries.navigation:navigationاز مخزن Mavengoogle(). نشانه: نسخه ۵.۰ و جدیدتر فقط بهصورتcom.google.android.libraries.navigation:navigationدر Google Maven عرضه میشود؛ بسته AAR دیگر توزیع نمیشود. راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار پیمایش برای Android» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
کیت توسعه نرمافزار پیمایش برای Android: نقشهها
- نقشه تعاملی و قابلسفارشیسازی را به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: برای 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). - شناسه نقشه بازکاربردپذیری برای ذخیره کردن پیکربندی نقشه و تنظیمات سبکپردازی ایجاد کنید.
- پاسخ دادن به تعاملات و رویدادهای کاربر روی نقشه.
- کنترلهایی را که روی نقشه نشان داده میشود سفارشیسازی کنید.
- اشارهها را برای کنترل نقشه سفارشیسازی کنید.
- کنترل بزرگنمایی و حرکت دادن در نقشه (دوربین).
- نوع نقشه را تغییر دهید.
- آرایش رنگهای نقشه را تغییر دهید.
- افزودن لایه ترافیک به نقشه.
کیت توسعه نرمافزار پیمایش برای Android: حاشیهنویسیهای Maps
- افزودن پنجره اطلاعات به نقشه.
- شکل یا خطی به نقشه اضافه کنید.
- تصویر رونهادی را که به سطح نقشه پایهمند شده است اضافه کنید.
- افزودن همپوشانی کاشی سفارشی به نقشه.
- افزودن نشانگر به نقشه. توجه: کیت توسعه نرمافزار پیمایش برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار پیمایش برای Android، نشانگرها را با GoogleMap.addMarker(MarkerOptions) اضافه کنید.
- سفارشیسازی نشانگر روی نقشه. توجه: کیت توسعه نرمافزار ناوبری برای Android از AdvancedMarkerOptions پشتیبانی نمیکند؛ هنگام استفاده از کیت توسعه نرمافزار ناوبری برای Android، نشانگرها را با MarkerOptions سفارشیسازی کنید.
- به تعاملات کاربر با نشانگرها در نقشه پاسخ دهید.
کیت توسعه نرمافزار پیمایش برای Android: سبکبندی Maps
کیت توسعه نرمافزار پیمایش برای Android: پیمایش
- ناوبری گامبهگام تعاملی را به برنامه تلفن همراه اضافه کنید.
- مقصد را برای ناوبری گامبهگام تنظیم کنید.
- برای ناوبری گامبهگام، ناوبری را شروع کنید.
- حالت سفر (رانندگی، پیادهروی، موتورسیکلت، تاکسی) را برای درخواست مسیر مشخص کنید.
- اولویتهای مسیریابی را برای ناوبری گامبهگام اصلاح کنید.
- سمت جاده و دیگر اولویتهای رسیدن را برای ناوبری گامبهگام مشخص کنید.
- بااستفاده از یک کد مسیر بازکاربردپذیر، مسیر برنامهریزیشده مجدد را برای ناوبری گامبهگام مشخص کنید.
- بهروزرسانیهای رسیدن کاربر را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای مکان کاربر را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای زمان و مسافت را از جلسه ناوبری گامبهگام برمیگرداند.
- بهروزرسانیهای تغییر مسیر برگشت از جلسه ناوبری گامبهگام.
- بهروزرسانیهای حالت شب را از جلسه ناوبری گامبهگام برگردانید.
- بهروزرسانیهای سرعت کاربر را از جلسه ناوبری گامبهگام برمیگرداند.
- عناصر و کنترلهای میانای کاربر را که درطول ناوبری گامبهگام نشان داده میشود سفارشیسازی کنید.
- عنصر میانای کاربر جدیدی به ناوبری گامبهگام اضافه کنید.
- نشانگر پیشرفت سفر را به ناوبری گامبهگام اضافه کنید.
- ویژگیهای نقشه را که درطول ناوبری گامبهگام نشان داده میشود سفارشیسازی کنید.
- افزودن لایه ترافیک به ناوبری گامبهگام.
- نمای دوربین و رفتار ناوبری گامبهگام را اصلاح کنید.
- هشدارهای سرعتسنج و حد مجاز سرعت را برای ناوبری گامبهگام سفارشیسازی کنید.
- فید ناوبری گامبهگام را بهصورت مجموعهای از پیامها برای هر مانور درطول مسیر برمیگرداند.
- نمادهای مانور سفارشی را برای استفاده با فید ناوبری گامبهگام مشخص کنید.
- افزودن ناوبری گامبهگام تعاملی برای Android Auto به برنامه Android. پیشدید
- به کاربران درباره اختلالات درطول مسیرشان هشدار دهید.
- به کاربران اجازه دهید قبلاز شروع ناوبری، اختلالات موجود در مسیرشان را مشاهده کنند.
- به کاربران اجازه دهید اختلالات درطول مسیرشان را گزارش کنند.
- به کاربران اجازه دهید اختلالات درطول مسیرشان را تأیید کنند.
- دکمه گزارش اختلال مسیر سفارشی اضافه کنید.