Fleet Engine Service-এর দ্রুত রেফারেন্স

Fleet Engine হল একটি ব্যাকএন্ড পরিষেবা যা আপনার বাস্তব-জগতের গাড়ির বহরকে মডেল করে এবং অন-ডিমান্ড ট্রিপ এবং শিডিউল করা টাস্কের জন্য রাউটিং, ETA, ট্রাফিক এবং স্ট্যাটাস আপডেট প্রদান করে। এটি Driver SDK থেকে লোকেশন ও রুট সংক্রান্ত ডেটা ব্যবহার করে এবং Consumer SDK ও অন্যান্য Google Maps Platform API-এর সাথে কাজ করে।

Fleet Engine Service: গুরুত্বপূর্ণ তথ্য

  • প্রোডাক্ট: Fleet Engine পরিষেবা
  • এছাড়াও এই নামে পরিচিত: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • বিভাগ: রুট
  • প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
  • রান করে: সার্ভার (ব্যাকএন্ড কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • ওভারভিউ: Fleet Engine Service ওভারভিউ

Fleet Engine পরিষেবা: কখন ব্যবহার করবেন

Fleet Engine পরিষেবা ব্যবহার করুন যখন:

  • আপনার এমন একটি ব্যাকএন্ড প্রয়োজন যা গাড়ি এবং অন-ডিমান্ড ট্রিপ (পিক-আপ, ওয়েপয়েন্ট, ড্রপ-অফ) মডেল করে, যার মধ্যে একাধিক গন্তব্য, ব্যাক-টু-ব্যাক বা শেয়ার করা ট্রিপ অন্তর্ভুক্ত।
  • আপনাকে শিডিউল করা ডেলিভারি বা গাড়ির জন্য অ্যাসাইন করা পরিষেবা টাস্কের মডেল তৈরি করতে হবে এবং তাদের স্টপ, ফলাফল ও ETA ট্র্যাক করতে হবে।
  • অনুরোধ করা রাইডের সাথে ম্যাচ করার জন্য আপনাকে কোনও অঞ্চলের গাড়ি সার্চ করতে বা তালিকাভুক্ত করতে হবে।
  • আপনার গ্রাহকের ট্রিপ বা শিপমেন্ট ট্র্যাকিং এবং ফ্লিট অপারেটর ট্র্যাকিং প্রয়োজন যা Driver SDK লোকেশন আপডেট থেকে পাওয়া যায়।

Fleet Engine পরিষেবা ব্যবহার করবেন না যখন:

  • ফ্লিট ইঞ্জিন ট্রিপ বা টাস্ক অর্কেস্ট্রেশন ছাড়াই আপনার নিজস্ব ডেটাবেস বা স্ট্রিম থেকে ওয়েব ম্যাপে লাইভ জিপিএস মার্কার বা অ্যাসেট পাথ দেখাতে হবে। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
  • ফ্লিট ইঞ্জিন ট্রিপ বা টাস্ক অর্কেস্ট্রেশন ছাড়াই আপনাকে Android অ্যাপে নিজের ডেটা থেকে লাইভ মার্কার বা পাথ দেখাতে হবে। পরিবর্তে Android-এর জন্য Maps SDK ব্যবহার করুন।
  • ফ্লিট ইঞ্জিন ট্রিপ বা টাস্ক অর্কেস্ট্রেশন ছাড়াই আপনাকে iOS অ্যাপে নিজের ডেটা থেকে লাইভ মার্কার বা পাথ দেখাতে হবে। পরিবর্তে iOS-এর জন্য Maps SDK ব্যবহার করুন।
  • আপনাকে অপ্টিমাইজ করা ফ্লিট-ওয়াইড রুট প্ল্যান গণনা করতে হবে; Fleet Engine শুধুমাত্র আপনার প্রদান করা সলভার থেকে রুট প্ল্যান নেয়। পরিবর্তে Route Optimization API ব্যবহার করুন।

Fleet Engine Service: সেট-আপ

  • পরিষেবা চালু করতে: fleetengine.googleapis.com
  • যাচাইকরণ: পরিষেবা অ্যাকাউন্ট, JSON ওয়েব টোকেন (JWT), OAuth 2.0
  • ব্যবহারের অ্যাট্রিবিউশন: ঐচ্ছিক বিটা ফিচার: মোবিলিটি প্যাকেজ পরিষেবায় কল করার সময় X-Goog-Maps-Experience-ID HTTP হেডারকে মোবিলিটি ট্রানজ্যাকশন আইডি (বা কোনও সম্পর্কিত আইডি, যেমন সেশন আইডি) হিসেবে সেট করুন; একাধিক আইডি কমা দিয়ে আলাদা করুন। ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানানোর সময় related_ids-এ যেকোনও সম্পর্কিত আইডি পাস করুন।
  • শুরু করা যাক: Fleet Engine পরিষেবা সেট-আপ করুন
  • রেফারেন্স: Fleet Engine Service রেফারেন্স
  • নীতি: Fleet Engine Service সংক্রান্ত নীতি
  • রিলিজ নোট: Fleet Engine Service-এর রিলিজ নোট

অফিসিয়াল Fleet Engine পরিষেবা প্যাকেজ:

  • maven: com.google.maps:google-maps-fleetengine
  • maven: com.google.maps:google-maps-fleetengine-delivery
  • npm: @googlemaps/fleetengine
  • npm: @googlemaps/fleetengine-delivery
  • pypi: google-maps-fleetengine
  • pypi: google-maps-fleetengine-delivery
  • যান: cloud.google.com/go/maps

Fleet Engine পরিষেবা: সাধারণ ভুল

  • সমস্যা: Fleet Engine-এ করা অনুরোধ মাঝে মাঝে ব্যর্থ হতে পারে এবং ব্যর্থ হওয়ার পরে, গাড়ির মতো এন্টিটি আর নাও থাকতে পারে (আপডেটের সময় NOT_FOUND)। সমাধান: ব্যাকঅফ সহ আবার চেষ্টা করুন (ক্লায়েন্ট লাইব্রেরি সাধারণত আবার চেষ্টা করে) এবং বর্তমান অবস্থায় অনুপস্থিত গাড়ি বা টাস্ক আবার তৈরি করুন। /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot দেখুন।
  • সমস্যা: ক্লায়েন্ট লাইব্রেরির ডিফল্ট টাইম-আউটের চেয়ে কোনও অনুরোধ বেশি সময় নিলে DEADLINE_EXCEEDED সমস্যা হয়। সমাধান: RPC আবার চেষ্টা করার সেটিংস অ্যাডজাস্ট করুন (যেমন, Java ক্লায়েন্টে VehicleServiceSettings-এ setTotalTimeout)। /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot দেখুন।
  • সমস্যা: PERMISSION_DENIED (HTTP 403) যখন JWT-তে সঠিক দাবি থাকে না বা সাইনিং পরিষেবা অ্যাকাউন্টে প্রয়োজনীয় Fleet Engine IAM ভূমিকা থাকে না (যেমন, "JWT-তে অনুরোধ করা ট্রিপের জন্য একটি ম্যাচিং স্কোপ নেই")। সমাধান: পরিষেবা অ্যাকাউন্টের ভূমিকা চেক করুন এবং নিশ্চিত করুন যে JWT ক্লেমে অ্যাক্সেস করা গাড়ি, ট্রিপ বা টাস্কের জন্য স্কোপ অন্তর্ভুক্ত রয়েছে। /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot দেখুন।
  • সমস্যা: অন-ডিমান্ড রাইড ও ডেলিভারি থেকে যেকোনও মোবিলিটি প্যাকেজে অথবা লাস্ট মাইল ফ্লিট সলিউশন থেকে মোবিলিটি অ্যাক্টিভেট বা অপ্টিমাইজে মাইগ্রেট করার সময়, মাইগ্রেশন সম্পূর্ণ না হওয়া পর্যন্ত মোবিলিটি বিলিং API অনুরোধ HTTP 202 রিটার্ন করে এবং বিলিং হয় না। সমাধান: মাইগ্রেশনের কয়েক দিন আগে থেকে শুরু করে কয়েক দিন পর পর্যন্ত Fleet Engine ReportBillableTrip এবং Mobility Billing API, দুটিকেই কল করুন, Cloud Logging-এ অনুরোধের সংখ্যা তুলনা করুন, তারপর ReportBillableTrip কল সরিয়ে দিন। /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration দেখুন।

Fleet Engine পরিষেবা: পুরনো এবং বন্ধ হয়ে যাওয়া ফিচার

  • UpdateVehicleLocation পদ্ধতি: ডিকমিশন করা হয়েছে ১ মে, ২০২৪ থেকে। পরিবর্তন: VehicleService-এ UpdateVehicle। লক্ষণ: ১ ফেব্রুয়ারি, ২০২৪ থেকে বন্ধ করা হয়েছে; মে, ২০২৪ থেকে আর কাজ করছে না।
  • SearchFuzzedVehicles পদ্ধতি: ডিকমিশন করা হয়েছে ১ মে, ২০২৪ থেকে। পরিবর্তন: VehicleService-এ SearchVehicles। লক্ষণ: ১ ফেব্রুয়ারি, ২০২৪ থেকে বন্ধ করা হয়েছে; মে, ২০২৪ থেকে আর কাজ করছে না।
  • SearchTasks পদ্ধতি: ডিকমিশন করা হয়েছে ১ মে, ২০২৪ থেকে। পরিবর্তন: DeliveryService-এ GetTaskTrackingInfo। লক্ষণ: ১ ফেব্রুয়ারি, ২০২৪ থেকে বন্ধ করা হয়েছে; মে, ২০২৪ থেকে আর কাজ করছে না।
  • ReportBillableTrip মোবিলিটি প্যাকেজে (যেকোনও প্যাকেজে অন-ডিমান্ড রাইড ও ডেলিভারি অথবা অ্যাক্টিভেট বা অপ্টিমাইজ করার জন্য লাস্ট মাইল ফ্লিট সলিউশন) মাইগ্রেট করার পরে: পুরনো। পরিবর্তন: Mobility Billing API reportBillableEvent। লক্ষণ: চুক্তি-নির্দিষ্ট, API বন্ধ হয়ে যাওয়া নয়। মাইগ্রেশনের পরে, কল "ভুল চুক্তি: এই প্রোজেক্ট [...] FleetEngine ব্যবহার করার জন্য অনুমোদিত নয়।" দেখাতে পারে। মাইগ্রেশন গাইড দেখুন।

Fleet Engine পরিষেবার মাধ্যমে আপনি কী করতে পারবেন

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