JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी सेट अप करना

JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी का इस्तेमाल करने से पहले, पक्का करें कि आपने फ़्लीट इंजन को सेट अप कर लिया हो और आपको इसके बारे में पता हो. ज़्यादा जानकारी के लिए, फ़्लीट इंजन देखें.

इस दस्तावेज़ में वेब पेज ऐप्लिकेशन और Fleet Engine के बीच अनुमति देने की सुविधा चालू करने का तरीका बताया गया है. अनुमति वाले सही टोकन के साथ, Fleet Engine को किए गए अनुरोध सेट अप हो जाने के बाद, मैप पर वाहन को ट्रैक किया जा सकता है.

अनुमति देने की सुविधा सेट अप करें

कम भरोसेमंद एनवायरमेंट से एपीआई के तरीके के कॉल के लिए, Fleet Engine को JSON वेब टोकन (JWT) का इस्तेमाल करना होगा. इन टोकन पर, किसी सही सेवा खाते से हस्ताक्षर किया जाना चाहिए. कम भरोसेमंद प्लैटफ़ॉर्म में स्मार्टफ़ोन और ब्राउज़र शामिल हैं. JWT आपके सर्वर से जनरेट होता है, जो पूरी तरह भरोसेमंद एनवायरमेंट होता है. JWT, तब तक साइन किया जाता है, एन्क्रिप्ट (सुरक्षित) किया जाता है, और क्लाइंट को भेजा जाता है, जब तक कि इसकी समयसीमा खत्म न हो जाए या वह अब मान्य न रहे.

आपके बैकएंड को ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल के स्टैंडर्ड तरीकों का इस्तेमाल करके, Fleet Engine के हिसाब से पुष्टि करनी चाहिए और अनुमति देनी चाहिए. पक्का करें कि आपने ऐसे JWT का इस्तेमाल किया हो जिन पर किसी मान्य सेवा खाते से हस्ताक्षर किया गया हो. सेवा खाते की भूमिकाओं की सूची के लिए, Fleet Engine की बुनियादी बातें में Fleet Engine के सेवा खाते की भूमिकाएं देखें.

इसके उलट, आपके बैकएंड को ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल के मानक तरीकों का इस्तेमाल करके, Fleet Engine के लिए पुष्टि करनी चाहिए और अनुमति देनी चाहिए.

अनुमति देने की प्रोसेस कैसे काम करती है?

Fleet Engine के डेटा के लिए अनुमति देने की प्रोसेस, सर्वर साइड और क्लाइंट-साइड, दोनों पर लागू होती है.

सर्वर साइड से अनुमति

फ़्लीट ट्रैकिंग ऐप्लिकेशन में पुष्टि करने और अनुमति देने की सुविधा सेट अप करने से पहले, यह ज़रूरी है कि आपका बैकएंड सर्वर, फ़्लीट इंजन का ऐक्सेस पाने के लिए आपके फ़्लीट ट्रैकिंग ऐप्लिकेशन को JSON वेब टोकन जारी कर सके. आपका फ़्लीट ट्रैकिंग ऐप्लिकेशन, इन JWTs को अपने अनुरोधों के साथ भेजता है. इससे Fleet Engine, अनुरोधों की पुष्टि ऐसे अनुरोधों के तौर पर करता है जिनकी पुष्टि की गई हो और जिन्हें डेटा को ऐक्सेस करने की अनुमति दी गई हो. सर्वर साइड JWT को लागू करने के बारे में निर्देश पाने के लिए, Fleet Engine Essentials में, गड़बड़ी JSON वेब टोकन देखें.

फ़्लीट ट्रैकिंग लागू करते समय, अपने सर्वर से टोकन जनरेट करने के लिए, यह तरीका अपनाएं:

• JSON वेब टोकन जारी करने के लिए सामान्य दिशा-निर्देश. इनमें, मांग पर यात्राएं और शेड्यूल किए गए टास्क, दोनों के लिए सेक्शन शामिल हैं
• ऑन-डिमांड यात्राएं: बैकएंड सर्वर ऑपरेशन के लिए टोकन का उदाहरण
• शेड्यूल किए गए टास्क: फ़्लीट में मौजूद सभी टास्क और वाहनों को ट्रैक करने के लिए, टोकन का उदाहरण

क्लाइंट-साइड की अनुमति देना

JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी का इस्तेमाल करने पर, यह ऑथराइज़ेशन टोकन फ़ेच करने वाले टूल का इस्तेमाल करके, सर्वर से टोकन का अनुरोध करता है. ऐसा तब होता है, जब इनमें से कोई भी शर्त पूरी हो:

• कोई मान्य टोकन मौजूद नहीं है. जैसे, जब SDK टूल ने नए पेज लोड होने पर फ़ेचर को कॉल नहीं किया है या जब फ़ेचर ने टोकन नहीं दिया है.

• टोकन की समय-सीमा खत्म हो गई है.

• टोकन की समय-सीमा खत्म होने के एक मिनट के भीतर है.

ऐसा न करने पर, JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी, पहले जारी किए गए मान्य टोकन का इस्तेमाल करती है और फ़ेच करने वाले को कॉल नहीं करती.

अनुमति टोकन फ़ेच करने वाला टूल बनाना

इन दिशा-निर्देशों का इस्तेमाल करके, अनुमति वाला टोकन फ़ेच करने वाला टूल बनाएं:

• फ़ेच करने वाले को दो फ़ील्ड वाला डेटा स्ट्रक्चर दिखाना चाहिए. इसे Promise में इस तरह लपेटा जाना चाहिए:

  • स्ट्रिंग token.

  • कोई नंबर expiresInSeconds. फ़ेच करने के बाद, टोकन की समयसीमा इस अवधि में खत्म हो जाती है. पुष्टि करने वाले टोकन को फ़ेच करने वाले को, लाइब्रेरी में फ़ेच करने के समय से लेकर खत्म होने के समय तक का समय सेकंड में देना होगा, जैसा कि उदाहरण में दिखाया गया है.

• टोकन पाने के लिए, फ़ेच करने वाले टूल को आपके सर्वर पर मौजूद यूआरएल को कॉल करना चाहिए. यह यूआरएल--SERVER_TOKEN_URL--आपके बैकएंड के लागू होने पर निर्भर करता है. यहां दिया गया उदाहरण यूआरएल, GitHub पर मौजूद ऐप्लिकेशन के बैकएंड के सैंपल के लिए है:

  • https://SERVER_URL/token/fleet_reader

उदाहरण - अनुमति टोकन फ़ेच करने वाला टूल बनाना

नीचे दिए गए उदाहरणों में, अनुमति टोकन फ़ेच करने वाला फ़ंक्शन बनाने का तरीका बताया गया है:

JavaScript

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,
  };
}

आगे क्या करना है

• किसी वाहन को ट्रैक करना
• सभी डिवाइसों को देखना