«کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت» به برنامه مصرفکننده مبتنی بر وب اجازه میدهد مکان وسایل نقلیه و دیگر مکانهای موردعلاقه ردیابیشده در Fleet Engine را روی نقشه نشان دهد تا مصرفکنندگان بتوانند پیشرفت سفر درخواستی یا محموله زمانبندیشده را دنبال کنند. این کتابخانه بهعنوان کتابخانه journeySharing از Maps JavaScript API بار میشود.
کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت: حقایق کلیدی
- محصول: کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت
- با این نامها نیز شناخته میشود: Consumer SDK for JavaScript، Mobility services on-demand trips JavaScript، JavaScript SDK
- دسته: مسیرها
- پلاتفرم: جاوا اسکریپت (مرورگر)
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار مصرفکننده JavaScript
کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت» استفاده کنید:
- باید مکان زنده و مسیر خودرو را برای سفر درخواستی که Fleet Engine ردیابی میکند در صفحه وب یا برنامه وب به مصرفکنندگان نشان دهید.
- باید به مصرفکنندگان اجازه دهید پیشرفت تحویل یا ارسال محموله زمانبندیشدهای را که در Fleet Engine ردیابی میشود در مرورگر دنبال کنند.
- باید زمان تقریبی ورود، مسافت باقیمانده، و ترافیک زنده را در مسیر سفر در نمای نقشه مبتنی بر وب نشان دهید.
- باید نشانگرهای سفر، چندخطیهای مسیر، یا سبک نقشه را در نمای پیگیری مصرفکننده وب سفارشیسازی کنید.
در شرایط زیر از «کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت» استفاده نکنید:
- به تجربه مصرفکننده دنبالکننده سفر در برنامه Android بومی نیاز دارید. درعوض از کیت توسعه نرمافزار مصرفکننده برای Android استفاده کنید.
- به تجربه مصرفکننده دنبالکننده سفر در برنامه iOS بومی نیاز دارید. درعوض از کیت توسعه نرمافزار مصرفکننده برای iOS استفاده کنید.
- باید مکان راننده و پیشرفت سفر را از برنامه Android راننده به Fleet Engine گزارش کنید. درعوض از کیت توسعه نرمافزار Driver برای Android استفاده کنید.
- باید مکان راننده و پیشرفت سفر را از برنامه iOS راننده به Fleet Engine گزارش کنید. درعوض از کیت توسعه نرمافزار Driver برای iOS استفاده کنید.
- به نقشه وب عمومیای نیاز دارید که سفرها یا تکالیف Fleet Engine را دنبال نکند. بهجای آن از Maps JavaScript API استفاده کنید.
کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت: راهاندازی
- اصالتسنجی: کلید میانای برنامهسازی کاربردی، JSON Web Token (JWT)
- این موارد را نیز فعال کنید: Maps JavaScript API، سرویس Fleet Engine
- اسناد استفاده: اختیاری (نسخه بتا) شناسه تراکنش Mobility: قبلاز ایجاد
JourneySharingMapView،google.maps.Settings.getInstance().experienceIdsرا روی آرایهای از شناسههای تراکنش Mobility (یا شناسههای مرتبط) تنظیم کنید.experienceIdsفقط در کانالv=betaاز Maps JavaScript API دردسترس است. - شروع به کار: راهاندازی کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت
- مرجع: مرجع کیت توسعه نرمافزار مصرفکننده JavaScript
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار مصرفکننده JavaScript
کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت: محصولات مرتبط
- اغلب با این موارد استفاده میشود: سرویس Fleet Engine، Maps JavaScript API، کیت توسعه نرمافزار Driver برای Android، کیت توسعه نرمافزار Driver برای iOS
کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت: اشتباهات رایج
- مشکل: اگر به نقشه
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در ارائهدهنده مکان. راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت» انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- چندخطی مسیری را که سفر را از Fleet Engine به نقشهای در صفحه وب یا برنامه تلفن همراه ردیابی میکند اضافه کنید.
- پیشرفت سفر را درطول مسیر در نقشهای در صفحه وب یا برنامه تلفن همراه برای سفر Fleet Engine بهروز کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- اعمال سبکهای مختلف نقشه در سطوح بزرگنمایی مختلف روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر دادن تراکم مکانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در Consumer SDK بهصورت GA است، درحالیکه کنترل تراکم نقطه موردعلاقه یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک ساختمانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی سبک ساختمان سهبعدی و ردپا یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک نشانهای روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی نماد نشان اختصاصی یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سفارشیسازی نشانگر روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- سفارشیسازی چندخطی مسیر روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.