JavaScript Consumer SDK কুইক রেফারেন্স

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: সেট-আপ

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-এর মাধ্যমে আপনি কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।