JavaScript Consumer SDK, ওয়েব-ভিত্তিক কনজিউমার অ্যাপকে, Fleet Engine-এ ট্র্যাক করা গাড়ির লোকেশন এবং অন্যান্য প্রাসঙ্গিক লোকেশন ম্যাপে দেখানোর সুবিধা দেয়, যাতে কনজিউমাররা অন-ডিমান্ড ট্রিপ বা শিডিউল করা শিপমেন্টের প্রোগ্রেস ফলো করতে পারেন। এটি Maps JavaScript API-এর journeySharing লাইব্রেরি হিসেবে লোড হয়।
JavaScript Consumer SDK: মূল তথ্য
- প্রোডাক্ট: জাভাস্ক্রিপ্ট কনজিউমার SDK
- এছাড়াও, এই নামে পরিচিত: জাভাস্ক্রিপ্টের জন্য কনজিউমার SDK, মোবিলিটি পরিষেবা অন-ডিমান্ড ট্রিপ জাভাস্ক্রিপ্ট, জাভাস্ক্রিপ্ট SDK
- বিভাগ: রুট
- প্ল্যাটফর্ম: জাভাস্ক্রিপ্ট (ব্রাউজার)
- এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: JavaScript Consumer SDK এক নজরে
JavaScript Consumer SDK: কখন ব্যবহার করবেন
এইসব ক্ষেত্রে জাভাস্ক্রিপ্ট কনজিউমার SDK ব্যবহার করুন:
- আপনাকে কোনও ওয়েব পেজ বা ওয়েব অ্যাপে, Fleet Engine ট্র্যাক করে এমন অন-ডিমান্ড ট্রিপের জন্য গ্রাহকদের গাড়ির লাইভ লোকেশন ও রুট দেখাতে হবে।
- আপনাকে গ্রাহকদের ব্রাউজারে Fleet Engine-এ ট্র্যাক করা শিডিউল করা শিপমেন্টের পিক-আপ বা ডেলিভারির প্রগ্রেস ফলো করার অনুমতি দিতে হবে।
- আপনাকে ওয়েব-ভিত্তিক ম্যাপ ভিউতে ট্রিপের জন্য রুটে ETA, বাকি দূরত্ব এবং লাইভ ট্রাফিক দেখাতে হবে।
- আপনাকে ওয়েব কনজিউমার ট্র্যাকিং ভিউতে ট্রিপ মার্কার, রুট পলিলাইন বা ম্যাপ স্টাইলিং কাস্টমাইজ করতে হবে।
এইসব ক্ষেত্রে জাভাস্ক্রিপ্ট কনজিউমার SDK ব্যবহার করবেন না:
- নেটিভ Android অ্যাপের মধ্যে ট্রিপ-ফলোয়িং গ্রাহক অভিজ্ঞতা প্রয়োজন। এর পরিবর্তে Android-এর জন্য Consumer SDK ব্যবহার করুন।
- নেটিভ iOS অ্যাপে ট্রিপ ফলো করার জন্য গ্রাহকের অভিজ্ঞতা প্রয়োজন। এর পরিবর্তে iOS-এর জন্য Consumer SDK ব্যবহার করুন।
- আপনাকে ড্রাইভারের Android অ্যাপ থেকে Fleet Engine-এ ড্রাইভারের লোকেশন ও ট্রিপের প্রোগ্রেস রিপোর্ট করতে হবে। পরিবর্তে Android-এর জন্য Driver SDK ব্যবহার করুন।
- আপনাকে ড্রাইভারের iOS অ্যাপ থেকে Fleet Engine-এ ড্রাইভারের লোকেশন ও ট্রিপের অগ্রগতি সম্পর্কে জানাতে হবে। পরিবর্তে iOS-এর জন্য Driver SDK ব্যবহার করুন।
- আপনার একটি সাধারণ ওয়েব ম্যাপ প্রয়োজন যা ফ্লিট ইঞ্জিন ট্রিপ বা টাস্ক অনুসরণ করে না। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
JavaScript Consumer SDK: সেট-আপ
- যাচাইকরণ: API কী, JSON ওয়েব টোকেন (JWT)
- এছাড়াও চালু করুন: Maps JavaScript API, Fleet Engine Service
- ব্যবহারের অ্যাট্রিবিউশন: ঐচ্ছিক (বিটা) মোবিলিটি ট্রানজ্যাকশন আইডি: আপনি
JourneySharingMapViewতৈরি করার আগেgoogle.maps.Settings.getInstance().experienceIds-কে মোবিলিটি ট্রানজ্যাকশন আইডির (বা সম্পর্কিত আইডি) অ্যারেতে সেট করুন।experienceIdsশুধুমাত্র Maps JavaScript API-এরv=betaচ্যানেলে উপলভ্য। - শুরু করুন: জাভাস্ক্রিপ্ট কনজিউমার SDK সেট-আপ করুন
- রেফারেন্স: JavaScript Consumer SDK রেফারেন্স
- রিলিজ নোট: JavaScript Consumer SDK রিলিজ নোট
জাভাস্ক্রিপ্ট কনজিউমার SDK: সম্পর্কিত প্রোডাক্ট
- সাধারণত এগুলির সাথে ব্যবহার করা হয়: Fleet Engine Service, Maps JavaScript API, Android-এর জন্য Driver SDK, iOS-এর জন্য Driver SDK
JavaScript Consumer SDK: সাধারণ ভুল
- সমস্যা: আপনি
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 দেখুন। - সমস্যা: আপনি
journeySharingলাইব্রেরি লোড না করা পর্যন্তgoogle.maps.journeySharingক্লাস উপলভ্য হবে না। সমাধান: Maps JavaScript API স্ক্রিপ্ট URL-এlibraries=journeySharingযোগ করুন অথবাawait google.maps.importLibrary("journeySharing")-এর মাধ্যমে ক্লাস লোড করুন। /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey দেখুন। - সমস্যা: ব্রাউজার (কম বিশ্বস্ত পরিবেশ) থেকে Fleet Engine কল করার জন্য আপনার ব্যাকএন্ড সার্ভার থেকে ইস্যু করা JWT প্রয়োজন। শুধু API কী ট্রিপ ডেটা অ্যাক্সেসের অনুমতি দেয় না। সমাধান: আপনার ব্যাকএন্ড থেকে JWT ইস্যু করুন এবং এমন একটি
authTokenFetcherপ্রদান করুন যা টোকেন এবংexpiresInSecondsফিরিয়ে দেয়। /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup দেখুন।
JavaScript Consumer SDK: লিগ্যাসি ও বন্ধ হয়ে যাওয়া ফিচার
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কলব্যাক। মাইগ্রেশন গাইড দেখুন।
JavaScript Consumer SDK-এর মাধ্যমে আপনি কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
- ফ্লিট ইঞ্জিন থেকে ওয়েব পেজ বা মোবাইল অ্যাপের ম্যাপে ট্রিপ ট্র্যাক করে এমন রুট পলিলাইন যোগ করুন।
- Fleet Engine ট্রিপের জন্য ওয়েব পেজ বা মোবাইল অ্যাপে ম্যাপের কোনও রুটে ট্রিপের প্রগ্রেস আপডেট করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে রাস্তা, পলিলাইন ও পলিগনের স্টাইল পরিবর্তন করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের অগ্রগতি ট্র্যাক করে এমন ম্যাপে ম্যাপ ফিচার দেখান বা লুকান।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে আইকন ও টেক্সট লেবেলের স্টাইল পরিবর্তন করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রগ্রেস ট্র্যাক করে এমন ম্যাপে বিভিন্ন জুম লেভেলে বিভিন্ন ম্যাপ স্টাইল প্রয়োগ করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে জায়গার ঘনত্ব পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে POI ডেনসিটি কন্ট্রোল হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে বিল্ডিংয়ের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে 3D এবং ফুটপ্রিন্ট বিল্ডিং স্টাইল কাস্টমাইজেশন হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে ল্যান্ডমার্কের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে ল্যান্ডমার্ক আইকন কাস্টমাইজেশন হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ম্যাপে এমন একটি মার্কার কাস্টমাইজ করুন যা Fleet Engine থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে।
- ম্যাপে রুট পলিলাইন কাস্টমাইজ করুন যা Fleet Engine থেকে ট্রিপের প্রগ্রেস ট্র্যাক করে।