JavaScript Consumer SDK-এর মাধ্যমে, আপনার গ্রাহক অ্যাপ, ওয়েব-ভিত্তিক ম্যাপে Fleet Engine-এ ট্র্যাক করা গাড়ির লোকেশন এবং অন্যান্য প্রাসঙ্গিক লোকেশন দেখাতে পারে। এর ফলে, আপনার গ্রাহকরা ড্রাইভারের যাত্রার অগ্রগতি দেখতে পাবেন। এই নির্দেশিকা ধরে নেয় যে আপনি Fleet Engine-কে তার সংশ্লিষ্ট Google Cloud প্রোজেক্ট এবং API কী-এর সাথে সেট-আপ করেছেন। আরও জানতে Fleet Engine দেখুন।
আপনি এইসব ধাপ অনুসরণ করে JavaScript Consumer SDK সেট-আপ করেছেন:
Maps JavaScript API চালু করা
Google Cloud Console-এ Maps JavaScript API চালু করুন। আরও বিবরণের জন্য, Google Cloud ডকুমেন্টেশনে API চালু করুন বিকল্প দেখুন। এটি জাভাস্ক্রিপ্টের জন্য Consumer SDK চালু করে।
অনুমোদন সেট-আপ করুন
কম-বিশ্বস্ত পরিবেশ: স্মার্টফোন এবং ব্রাউজার থেকে API মেথড কলের জন্য Fleet Engine-এর JSON ওয়েব টোকেন (JWTs) ব্যবহার করা প্রয়োজন।
আপনার সার্ভারে একটি JWT তৈরি হয়, সেটি সাইন ও এনক্রিপ্ট করা হয় এবং ক্লায়েন্টের কাছে পাঠানো হয় যাতে মেয়াদ শেষ না হওয়া বা আর বৈধ না থাকা পর্যন্ত সার্ভারের সাথে ইন্টার্যাক্ট করা যায়।
গুরুত্বপূর্ণ বিবরণ
- Fleet Engine-এর সাথে যাচাই ও অনুমোদন করতে অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করুন।
- JWT-তে সাইন করতে উপযুক্ত পরিষেবা অ্যাকাউন্ট ব্যবহার করুন। Fleet Engine-এর প্রাথমিক তথ্য থেকে Fleet Engine serviceaccount-এর ভূমিকা দেখুন।
অনুমোদন কীভাবে কাজ করে?
Fleet Engine ডেটার সাথে অনুমোদনের মধ্যে সার্ভার-সাইড এবং ক্লায়েন্ট-সাইড বাস্তবায়ন উভয়ই জড়িত।
সার্ভার-সাইড অনুমোদন
আপনার ওয়েব-ভিত্তিক অ্যাপ্লিকেশনে যাচাইকরণ ও অনুমোদন সেট-আপ করার আগে, আপনার ব্যাকএন্ড সার্ভারকে Fleet Engine অ্যাক্সেস করার জন্য আপনার ওয়েব-ভিত্তিক অ্যাপ্লিকেশনে JSON ওয়েব টোকেন ইস্যু করতে পারতে হবে। আপনার ওয়েব-ভিত্তিক অ্যাপ্লিকেশন অনুরোধের সাথে এই JWT পাঠায় যাতে Fleet Engine অনুরোধটি যাচাই করে এবং অনুরোধে থাকা ডেটা অ্যাক্সেস করার জন্য অনুমোদিত হিসেবে শনাক্ত করে। সার্ভার-সাইড JWT প্রয়োগ করার নির্দেশাবলীর জন্য, Fleet Engine Essentials-এর অধীনে JSON Web Tokens ইস্যু করুন দেখুন।
বিশেষ করে, ট্রিপের প্রগ্রেস শেয়ার করার জন্য JavaScript Consumer SDK-এর ক্ষেত্রে নিম্নলিখিত বিষয়গুলি মনে রাখবেন:- JSON ওয়েব টোকেন ইস্যু করার জন্য সাধারণ নির্দেশিকা
- চাহিদা অনুযায়ী ট্রিপের JWT সংক্রান্ত নির্দেশিকা
- গ্রাহক অপারেশনের জন্য টোকেনের উদাহরণ
ক্লায়েন্ট-সাইড অনুমোদন
আপনি যখন JavaScript Consumer SDK ব্যবহার করেন, তখন এটি একটি অনুমোদন টোকেন ফেচার ব্যবহার করে সার্ভার থেকে একটি টোকেনের অনুরোধ করে। নিম্নলিখিতগুলির মধ্যে যেকোনও একটি সঠিক হলে এটি এমন করে:
কোনও বৈধ টোকেন নেই, যেমন SDK কোনও নতুন পৃষ্ঠা লোডে ফেচারকে কল করেনি, অথবা ফেচার কোনও টোকেন ফেরত দেয়নি।
টোকেনের মেয়াদ শেষ হয়ে গেছে।
টোকেনের মেয়াদ শেষ হতে এক মিনিটেরও কম সময় বাকি আছে।
অন্যথায়, JavaScript Consumer SDK আগে ইস্যু করা, সঠিক টোকেন ব্যবহার করে এবং ফেচারকে কল করে না।
একটি অনুমোদন টোকেন ফেচার তৈরি করুন
এইসব নির্দেশিকা ব্যবহার করে আপনার অথরাইজেশন টোকেন ফেচার তৈরি করুন:
ফেচারকে অবশ্যই দুটি ফিল্ড সহ একটি ডেটা স্ট্রাকচার রিটার্ন করতে হবে, যা নিম্নলিখিতভাবে
Promise-এ মোড়ানো থাকে:একটি স্ট্রিং
token।expiresInSecondsনম্বর। ফেচ করার পরে এই পরিমাণ সময়ের মধ্যে টোকেনের মেয়াদ শেষ হয়ে যায়। যাচাইকরণ টোকেন ফেচারকে অবশ্যই সেকেন্ডে মেয়াদ শেষ হওয়ার সময় পাস করতে হবে, উদাহরণে দেখানো হিসাবে লাইব্রেরিতে আনার সময় থেকে।
টোকেন ফিরিয়ে আনতে ফেচারকে আপনার সার্ভারে একটি URL কল করতে হবে। এই URL--
SERVER_TOKEN_URL--আপনার ব্যাকএন্ড ইমপ্লিমেন্টেশনের উপর নির্ভর করে। নিম্নলিখিত উদাহরণ URLটি GitHub-এ স্যাম্পেল অ্যাপ ব্যাকএন্ড-এর জন্য:https://SERVER_URL/token/consumer/TRIPID
উদাহরণ -- যাচাইকরণ টোকেন ফেচার তৈরি করুন
কীভাবে অথরাইজেশন টোকেন ফেচার তৈরি করতে হয় তা নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন:
জাভাস্ক্রিপ্ট
async function authTokenFetcher(options) {
// options is a record containing two keys called
// serviceType and context. The developer should
// generate the correct SERVER_TOKEN_URL and request
// based on the values of these fields.
const response = await fetch(SERVER_TOKEN_URL);
if (!response.ok) {
throw new Error(response.statusText);
}
const data = await response.json();
return {
token: data.Token,
expiresInSeconds: data.ExpiresInSeconds
};
}
TypeScript
function authTokenFetcher(options: {
serviceType: google.maps.journeySharing.FleetEngineServiceType,
context: google.maps.journeySharing.AuthTokenContext,
}): Promise<google.maps.journeySharing.AuthToken> {
// The developer should generate the correct
// SERVER_TOKEN_URL based on options.
const response = await fetch(SERVER_TOKEN_URL);
if (!response.ok) {
throw new Error(response.statusText);
}
const data = await response.json();
return {
token: data.token,
expiresInSeconds: data.ExpiresInSeconds,
};
}