مرجع سریع کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت

«کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت» به برنامه مصرف‌کننده مبتنی بر وب اجازه می‌دهد مکان وسایل نقلیه و دیگر مکان‌های موردعلاقه ردیابی‌شده در Fleet Engine را روی نقشه نشان دهد تا مصرف‌کنندگان بتوانند پیشرفت سفر درخواستی یا محموله زمان‌بندی‌شده را دنبال کنند. این کتابخانه به‌عنوان کتابخانه journeySharing از Maps JavaScript API بار می‌شود.

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

  • محصول: کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت
  • با این نام‌ها نیز شناخته می‌شود: Consumer SDK for JavaScript،‏ Mobility services on-demand trips JavaScript،‏ JavaScript SDK
  • دسته: مسیرها
  • پلاتفرم: جاوا اسکریپت (مرورگر)
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار مصرف‌کننده JavaScript

کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت: زمان استفاده از آن

در موارد زیر از «کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت» استفاده کنید:

  • باید مکان زنده و مسیر خودرو را برای سفر درخواستی که Fleet Engine ردیابی می‌کند در صفحه وب یا برنامه وب به مصرف‌کنندگان نشان دهید.
  • باید به مصرف‌کنندگان اجازه دهید پیشرفت تحویل یا ارسال محموله زمان‌بندی‌شده‌ای را که در Fleet Engine ردیابی می‌شود در مرورگر دنبال کنند.
  • باید زمان تقریبی ورود، مسافت باقی‌مانده، و ترافیک زنده را در مسیر سفر در نمای نقشه مبتنی بر وب نشان دهید.
  • باید نشانگرهای سفر، چندخطی‌های مسیر، یا سبک نقشه را در نمای پیگیری مصرف‌کننده وب سفارشی‌سازی کنید.

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

کیت توسعه نرم‌افزار مصرف‌کننده جاوا اسکریپت: راه‌اندازی

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

  • مشکل: اگر به نقشه JourneySharingMapView نمای اولیه (مرکز و بزرگ‌نمایی) ندهید، ممکن است رویداد 'ready' نقشه اجرا نشود. اصلاح: پس‌از ایجاد نمای نقشه، mapView.map.setCenter(...) و mapView.map.setZoom(...) را فراخوانی کنید. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey را ببینید.
  • مشکل: خطاهای ناشی از درخواست‌های ناهمگام اطلاعات سفر، استثنا ایجاد نمی‌کنند. آن‌ها فقط به‌عنوان رویدادهای 'error' در ارائه‌دهنده مکان می‌رسند، بنابراین موردتوجه قرار نمی‌گیرند مگراینکه شنونده اضافه کنید. اصلاح: locationProvider.addListener('error', ...) را اضافه کنید و فراخوانی‌های کتابخانه را در بلوک‌های try...catch قرار دهید. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey را ببینید.
  • مشکل: کلاس‌های google.maps.journeySharing دردسترس نیستند مگراینکه کتابخانه journeySharing را بار کنید. اصلاح: libraries=journeySharing را به نشانی وب اسکریپت Maps JavaScript API اضافه کنید، یا کلاس‌ها را با await google.maps.importLibrary("journeySharing") بار کنید. /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey را ببینید.
  • مشکل: تماس‌های Fleet Engine از مرورگر (محیطی با اعتماد پایین) به JWTهایی نیاز دارند که سرور زیرینه شما صادر می‌کند. کلید میانای برنامه‌سازی کاربردی به‌تنهایی دسترسی به داده‌های سفر را مجاز نمی‌کند. رفع مشکل: JWTها را از پس‌بک خود صادر کنید و authTokenFetcher ارائه دهید که توکن و expiresInSeconds را برمی‌گرداند. /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup را ببینید.

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

  • JourneySharingMapView و JourneySharingMapViewOptions گزینه‌های راه‌اندازی نشانگر و چندخطی (vehicleMarkerSetup، originMarkerSetup، destinationMarkerSetup، waypointMarkerSetup، anticipatedRoutePolylineSetup، takenRoutePolylineSetup، و غیره): منسوخ‌شده. جایگزین: گزینه‌های MarkerCustomizationFunction و PolylineCustomizationFunction در ارائه‌دهنده مکان (برای مثال، vehicleMarkerCustomization). نشانه: برای حذف در نسخهٔ پخش آتی زمان‌بندی شده است. راهنمای انتقال را ببینید.
  • JourneySharingMapView.locationProvider و JourneySharingMapViewOptions.locationProvider: منسوخ شده است. جایگزین: JourneySharingMapView.locationProviders و JourneySharingMapViewOptions.locationProviders.
  • JourneySharingMapView ویژگی‌های فهرست چندخطی و نشانگر (vehicleMarkers، originMarkers، destinationMarkers، waypointMarkers، anticipatedRoutePolylines، takenRoutePolylines، و ویژگی‌های نشانگر تکلیف): منسوخ‌شده. جایگزین: بازخوانی‌های MarkerCustomizationFunction و PolylineCustomizationFunction در ارائه‌دهنده مکان. راهنمای انتقال را ببینید.

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

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