در روز انجمن توسعه‌دهندگان Google Maps Platform بعدی ما در ماه دسامبر در سانفرانسیسکو به ما بپیوندید! برای شرکت کردن، اکنون درخواست دهید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

پرسشگان

جزئیات محصول

اعلان «شرایط خدمات کیت توسعه نرم‌افزار ناوبری» چگونه باید نشان داده شود؟: برنامه شما باید کادر گفتگویی را با اعلان «شرایط خدمات» Navigation SDK پیاده‌سازی کند که هر کاربر باید آن را بپذیرد. این کادر گفتگو به کاربر فرصت می‌دهد با «شرایط خدمات» موافقت کند. فایل نوشتاری شرایط با Navigation SDK ارائه شده است. از روش NavigationApi.showTermsAndConditionsDialog برای نمایش کادر گفتگوی حاوی شرایط استفاده کنید.
راهنمای صوتی از کدام زبان‌ها پشتیبانی می‌کند؟: هر زبانی که Google Maps Mobile از آن پشتیبانی می‌کند به‌طور خودکار برای Navigation SDK دردسترس است. دستگاه دارای زبان سیستم پیش‌فرض است و برنامه نمی‌تواند آن تنظیم را تغییر دهد؛ بااین‌حال، برنامه به بیش‌از ۷۰ زبان دسترسی دارد.
آیا وقتی کاربر از حالت ناوبری خارج می‌شود، جهت حفظ می‌شود؟: بله. پس‌از شروع، LocationListener همچنان در پس‌زمینه اجرا می‌شود. برنامه شما به چسباندن موقعیت به جاده ادامه می‌دهد و جهت را حفظ می‌کند.
آیا چندخطی‌ها هنگام شروع یا تغییر مسیر دردسترس هستند؟: بله. وقتی مسیری ایجاد یا تغییر داده می‌شود، RouteChangeListener چندخطی‌ها را ارائه می‌دهد.
آیا کاربران برنامه باید Google Maps Mobile را نصب کرده باشند؟: نه، Navigation SDK نیازی به نصب Google Maps Mobile روی دستگاه ندارد.
آیا «کیت توسعه نرم‌افزار ناوبری» می‌تواند پارکینگ‌های نزدیک رستوران‌ها و دیگر نقاط جالب را شناسایی کند؟: نه، Navigation SDK درحال‌حاضر این ویژگی را ارائه نمی‌دهد.
آیا «کیت توسعه نرم‌افزار ناوبری» جهت ترافیک را در لاین‌ها هنگام نزدیک شدن به نقطه گردش نشان می‌دهد؟: بله. جهت ترافیک دردسترس است و به‌طور پیش‌فرض نمایش داده می‌شود.
کیت توسعه نرم‌افزار ناوبری از کدام نسخه‌های کیت توسعه جاوا پشتیبانی می‌کند؟: کیت توسعه نرم‌افزار Navigation از نسخه‌های LTS (پشتیبانی بلندمدت) Java SE که به‌طور فعال توسط Oracle پشتیبانی می‌شوند پشتیبانی می‌کند. این نسخه‌ها در نقشه راه پشتیبانی Oracle Java SE به‌عنوان نسخه‌های دارای پشتیبانی Premier فهرست شده‌اند.

شبکه و اتصال‌پذیری

کیت توسعه نرم‌افزار پیمایش چگونه اتصال‌پذیری ضعیف شبکه را مدیریت می‌کند؟

کیت توسعه نرم‌افزار پیمایش مسیر هر سفر را ازقبل ذخیره می‌کند. اطلاعات پیش‌نهان‌سازی‌شده شامل اطلاعات مسیریابی برای ۱۵ تا ۲۰ دقیقه، و مسیرهای جایگزین درصورت انحراف کاربر از مسیر است. کیت توسعه نرم‌افزار ناوبری موقعیت را بااستفاده از GPS و حسگرهای دستگاه تخمین می‌زند.

کیت توسعه نرم‌افزار پیمایش چگونه سیگنال‌های GPS ضعیف یا ازدست‌رفته را مدیریت می‌کند؟

پس‌از شروع ناوبری و دریافت سیگنال GPS توسط Navigation SDK برای حداقل یک‌بار، در شرایط زیر پیام «درحال جستجوی GPS…» نمایش داده می‌شود:

اگر بیش‌از ۱۰ ثانیه از آخرین باری که سیگنال GPS دریافت کرده است گذشته باشد.
اگر موقعیت مسیریابی از آخرین باری که سیگنال GPS دریافت کرده است بیش‌از ۵۰۰ متر جابه‌جا شده باشد.

اگر کیت توسعه نرم‌افزار برای مدت طولانی سیگنال GPS دریافت نکند، پیشرفت درطول مسیر (که در برنامه با موقعیت نشانگر مشخص می‌شود) ممکن است کند شود تا اینکه کاملاً متوقف شود. در این حالت، نشانگر روی نقشه در مکانی که آخرین سیگنال GPS نشان داده است باقی می‌ماند. کیت توسعه نرم‌افزار به‌دلیل دریافت نکردن سیگنال GPS به‌طور خودکار از حالت پیمایش خارج نخواهد شد. اما ممکن است تا زمانی که دوباره سیگنال دریافت نکند نتواند راهنمایی ارائه دهد.

حالت آفلاین دردسترس است؟

نه، Navigation SDK درحال‌حاضر حالت آفلاین ارائه نمی‌دهد؛ اما SDK اطلاعات پیش‌نهان‌سازی‌شده برای سفر ارائه می‌دهد.

داده

آیا می‌توانم قبل‌از شروع مسیر، همه ایستگاه‌ها/مقصدهای سفر را بازیابی کنم؟

بله. برای بازیابی مسیرهای یک مسیر، با Navigator.getRouteSegments() تماس بگیرید.

آیا راهنمای مسیر گام‌به‌گام در شروع مسیر دردسترس است؟

بله. «کیت توسعه نرم‌افزار ناوبری» فهرستی از بخش‌های مسیر را ارائه می‌دهد. علاوه‌براین، کاربر می‌تواند با تند کشیدن روی کارت مسیرها در سرصفحه، هر مانور را ببیند.

زمان تخمینی رسیدن چگونه به کاربران برنامه اطلاع داده می‌شود؟

برای ارائه اطلاعات زمان تخمینی ورود به کاربران برنامه، مراحل زیر را دنبال کنید:

زمان و فاصله را برای همه نقطه‌مسیرها بااستفاده از Navigator.getTimeAndDistanceList() بازیابی کنید.
این اطلاعات را به برنامه کارخواه بازارسال کنید، همان‌طور که برای زمان تقریبی ورود راننده انجام می‌دهید.

آیا می‌توان از RoadSnappedLocationProvider برای دریافت مکان چسبیده فعلی کاربر درصورت عدم حضور ناوبری در پیش‌نما استفاده کرد؟

بله. ‫RoadSnappedLocationProvider به‌طور پیش‌فرض در پس‌زمینه اجرا می‌شود.

آیا Navigation SDK از حصارکشی جغرافیایی پشتیبانی می‌کند؟

نه. در زمینه پیمایش، remainingTimeOrdistanceChangeListener نسبت به حصار جغرافیایی برتری دارد. حصار جغرافیایی ممکن است هندسه جاده را درنظر نگیرد و ممکن است دقیقاً در نقطه‌ای که کاربر به آن پیمایش می‌کند متمرکز نباشد.

می‌توانید این ویژگی را بااستفاده از remainingTimeOrdistanceChangeListener تخمین بزنید.

آستانه را برای تعیین بسامد بازخوانی‌ها تنظیم کنید.
مسافت باقی‌مانده تا مقصد را بررسی کنید.

برای مثال، اگر آستانه را روی ۱۰۰ متر تنظیم کنید، وقتی فاصله تا مقصد ۱۰۰ متر تغییر کند، فراخوانی برگشتی دریافت می‌کنید. با کاهش فاصله، می‌توانید این آستانه را به مقدار کوچک‌تری به‌روز کنید و فراخوانی‌های بیشتری دریافت کنید. سپس، فاصله باقی‌مانده را بررسی کنید تا ببینید به‌اندازه کافی به مکان سوار کردن/پیاده کردن نزدیک هستید یا نه.

آیا می‌توانم اعلان‌ها را وقتی برنامه «ناوبری» در پس‌زمینه است غیرفعال کنم؟

بله. از Navigator.setHeadsUpNotificationEnabled برای کنترل اعلان‌ها استفاده کنید. این روش یک متغیر مستقل بولی دارد. FALSE اعلان‌ها را غیرفعال می‌کند؛ TRUE اعلان‌ها را فعال می‌کند.

چگونه می‌توانم گزارش تراکنش‌های نگهداری‌شده توسط Google را ببینم؟

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

سفارشی‌سازی میانای کاربر

آیا می‌توانم بهترین گزینه مسیر را با رنگ مشخص کنم؟

نه. درحال‌حاضر کدگذاری رنگی گزینه مسیر خاصی پشتیبانی نمی‌شود.

آیا Navigation SDK می‌تواند زمان تخمینی رسیدن به مقصد نهایی را نشان دهد؟

بله. از روش‌های زیر استفاده کنید:

زمان و فاصله را برای همه نقطه‌مسیرها بااستفاده از Navigator.getTimeAndDistanceList() بازیابی کنید.
پنهان کردن زمان تخمینی رسیدن به نقطه‌مسیر فعلی بااستفاده از NavigationFragment.setEtaCardEnabled(false).
زمان تقریبی رسیدن به مقصد نهایی را پرداز بزنید.

چگونه می‌توانم به‌روزرسانی‌های زمان تخمینی ورود را پنهان کنم؟

می‌توانید کارت‌های زمان تخمینی ورود را با تماس با navigationView.setEtaCardEnabled(false) غیرفعال کنید.

کدام سفارشی‌سازی‌های واسط کاربر برای کارت‌های سرصفحه و پاصفحه دردسترس است؟

از StylingOptions برای تنظیم سبک رنگ پس‌زمینه استفاده کنید. برای پنهان کردن یا نمایش دادن سرصفحه و پاصفحه، از توابع عضو setHeaderEnabled و setFooterEnabled NavigationFragment استفاده کنید.

مسیریابی

آیا می‌توانم مسیر خاصی را به کاربر ارائه دهم یا مسیرهای جایگزین را حذف کنم؟

نه. به‌طور پیش‌فرض، چندین مسیر ارائه می‌شود و سریع‌ترین مسیر اولویت دارد. می‌توانید با افزودن اولویت‌هایی مثل «اجتناب از بزرگراه‌ها و عوارضی‌ها» به درخواستتان، بر مسیر پیش‌فرض تأثیر بگذارید. افزودن نقطه‌مسیر نیز بر مسیر تأثیر می‌گذارد.

آیا می‌توانم برچسب متفاوتی برای مقصد نسبت‌به مکان مقصد پیش‌فرض به کاربر برنامه نشان دهم؟

بله. Marker با عنوان سفارشی برای مقصد و طول/عرض جغرافیایی ایجاد کنید. کیت توسعه نرم‌افزار ناوبری عنوان سفارشی و مختصات را در NavigationMap نمایش می‌دهد.

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

بله. از Navigator.setRouteChangedListener برای دریافت اعلان هنگام تغییر مسیر یا توصیه مسیر جدید استفاده کنید:

شنونده‌ای را ثبت کنید که موقعیت دستگاه را درطول مسیر بااستفاده از روش Navigator.setRouteChangedListener بررسی می‌کند.
کد را به رسیدگی‌کننده رویداد بازخوانی، onRouteChanged، اضافه کنید:
- پیامی با اطلاعات به‌روزشده زمان تخمینی ورود و فاصله به کاربر برنامه ارسال کنید.
- مکان دستگاه را ردیابی کنید.
- [اختیاری] ویژگی‌های دیگری را که برنامه‌تان برای رسیدگی به زمانی که کاربر خارج از مسیر تعیین‌شده است نیاز دارد اضافه کنید.

آیا کاربر می‌تواند بدون تکمیل مسیر از ناوبری خارج شود؟

بله. برای توقف پیمایش، روش Navigator.stopGuidance را فراخوانی کنید.

آیا «کیت توسعه نرم‌افزار ناوبری» از مسیریابی و ناوبری برای کامیون‌ها و خودروهای بزرگ پشتیبانی می‌کند؟

بله. با مسیریابی خودروهای بزرگ (LVR)، می‌توانید توکن‌های مسیر مختص کامیون را که توسط Routes API یا Route Optimization API تولید شده‌اند به Navigation SDK ارسال کنید. این کیت توسعه نرم‌افزار ناوبری گام‌به‌گام با فراخوانی‌های مسیر (ارتفاع، وزن، مواد خطرناک، و محدودیت‌های کامیون) ارائه می‌دهد و نمایه فیزیکی خودرو را درطول مسیریابی مجدد پویا حفظ می‌کند. برای جزئیات، به پیمایش مسیرهای وسایل نقلیه بزرگ مراجعه کنید.

شبیه‌ساز

آیا شبیه‌ساز از تغییرات مسیر پشتیبانی می‌کند؟: بله. برای شبیه‌سازی سفری که شامل تغییر مسیر است، simulateLocationsAlongNewRoute را فراخوانی کنید. روش simulateLocationsAlongExistingRoute تغییرات مسیر موجود را نادیده می‌گیرد.

گردش کار

چگونه می‌توانم پس‌از بستن فعالیتی که حاوی قطعه ناوبری است، اعلان را ببندم؟

اعلان ناوبری درطول ناوبری، وقتی فعالیت بسته است، نمایان می‌ماند. وقتی خودرو به مقصد می‌رسد، ناوبری متوقف می‌شود و اعلان ناپدید می‌شود.

برای مدیریت کلیک‌ها روی اعلان، از Navigator.startGuidance(intent resumeIntent) استفاده کنید. وقتی کاربر برنامه روی اعلان کلیک می‌کند، resume intent فعال می‌شود. معمولاً Navigator.startguidance(getIntent()) از Activity اصلی فراخوانی می‌شود که وقتی کاربر برنامه روی اعلان کلیک می‌کند، Activity را دوباره فراخوانی می‌کند.

سرویس‌های جابه‌جایی

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

«سرویس‌های جابه‌جایی Google Maps Platform» مجموعه‌ای از میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار را برای کمک به پشتیبانی از نیازهای سازمانی کسب‌وکارهای حمل‌ونقل و لجستیک ارائه می‌دهد. برای مشتریان «سرویس‌های جابه‌جایی»، Navigation SDK معمولاً همراه با سرویس‌های مرتبط برای بهینه‌سازی مسیر، اعزام، پیگیری تکلیف، تجزیه‌وتحلیل ناوگان، و غیره استفاده می‌شود. صدور صورت‌حساب «کیت توسعه نرم‌افزار پیمایش» برای مشتریان «سرویس‌های جابه‌جایی» نیز متفاوت است. برای اطلاعات بیشتر، به مستندات سرویس‌های جابه‌جایی مراجعه کنید.

محصولات جابه‌جایی درحال‌حاضر فقط برای مشتریان منتخب دردسترس است. برای اطلاعات بیشتر، با نماینده فروش تماس بگیرید.

چگونه می‌توانم متوجه شوم که مشتری «خدمات جابه‌جایی» هستم؟

اگر مطمئن نیستید که درحال‌حاضر «کیت توسعه نرم‌افزار ناوبری» را به‌عنوان مشتری «خدمات جابه‌جایی» پیاده‌سازی می‌کنید یا نه، به‌دنبال فراخوانی ReportBillableEvent در کدتان بگردید. فقط مشتریان «خدمات جابه‌جایی» باید روش ReportBillableEvent را فراخوانی کنند.

صدور صورت‌حساب Navigation SDK برای مشتریان Mobility Services چگونه است؟

برای مشتریان «سرویس‌های جابه‌جایی»، صورت‌حساب و قیمت‌گذاری Navigation SDK به قرارداد خدماتی که با Google Maps Platform دارید بستگی دارد. برای کسب اطلاعات درباره تأیید اینکه پیاده‌سازی «سرویس‌های جابه‌جایی» شما به‌درستی صورت‌حساب می‌شود، به اعتبارسنجی صورت‌حساب مراجعه کنید. برای اطلاعات بیشتر درباره صورت‌حساب «خدمات جابه‌جایی»، با نماینده فروش خود تماس بگیرید.

کدام میاناهای برنامه‌سازی کاربردی Navigation SDK باید فقط توسط مشتریان «سرویس‌های جابه‌جایی» استفاده شود؟

چندین میانای برنامه‌سازی کاربردی در «کیت توسعه نرم‌افزار ناوبری» وجود دارد که فقط برای استفاده مشتریان سرویس‌های جابه‌جایی درنظر گرفته شده است، که Google براساس هر تراکنش برای آن‌ها صورت‌حساب صادر می‌کند. اگر مشتری «سرویس‌های جابه‌جایی» نیستید، روش‌های زیر بدون‌عمل هستند:

اگر مشتری «سرویس‌های جابه‌جایی» باشم، آیا می‌توانم از پیاده‌سازی غیر«سرویس‌های جابه‌جایی» Navigation SDK نیز استفاده کنم؟

بله، مشتریان «خدمات جابه‌جایی» می‌توانند از هر دو پیاده‌سازی «خدمات جابه‌جایی» و غیر«خدمات جابه‌جایی» Navigation SDK استفاده کنند. بااین‌حال، در هر زمان فقط می‌توانید از یک نوع پیاده‌سازی در برنامه استفاده کنید. همچنین باید پروژه Google Cloud، حساب صورت‌حساب، و کلید API جدیدی ایجاد کنید که از موارد استفاده‌شده در پیاده‌سازی «سرویس‌های جابه‌جایی» شما جدا باشد. برای اطلاعات بیشتر، نمای کلی راه‌اندازی Navigation SDK را ببینید.

برای کسب اطلاعات بیشتر درباره استفاده از پیاده‌سازی غیر Mobility Services از Navigation SDK، ازجمله انتقال برنامه از یک نوع پیاده‌سازی به نوع دیگر، با نماینده حساب Google خود تماس بگیرید.

توجه: اگر درحال‌حاضر مشتری «سرویس‌های جابه‌جایی» نیستید و می‌خواهید درباره مجموعه میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار «سرویس‌های جابه‌جایی» بیشتر بدانید، با بخش فروش پلاتفرم Google Maps تماس بگیرید.