JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी के साथ शिपमेंट ट्रैक करें

JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी की मदद से, Fleet Engine में ट्रैक किए गए वाहनों की जगह और दिलचस्पी वाली जगहों की जगह को विज़ुअलाइज़ किया जा सकता है. लाइब्रेरी में JavaScript का एक मैप कॉम्पोनेंट होता है. यह स्टैंडर्ड google.maps.Map इकाई और Fleet Engine से कनेक्ट करने के लिए, डेटा कॉम्पोनेंट को ड्रॉप-इन करता है. JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी का इस्तेमाल करके, अपने वेब ऐप्लिकेशन से पसंद के मुताबिक बनाया जा सकने वाला ऐनिमेटेड शिपमेंट ट्रैकिंग अनुभव दिया जा सकता है.

घटक

JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी से, वाहन और रास्ते के डेस्टिनेशन को दिखाने के लिए कॉम्पोनेंट दिखाए जाते हैं. साथ ही, इससे ड्राइवर के ETA या ड्राइव के लिए बची हुई दूरी के लिए, रॉ डेटा फ़ीड होने की जानकारी भी मिलती है.

शिपमेंट ट्रैकिंग का मैप व्यू

मैप व्यू कॉम्पोनेंट, वाहनों और डेस्टिनेशन की जगह की जानकारी दिखाता है. अगर किसी वाहन का रास्ता जाना जा चुका है, तो मैप व्यू कॉम्पोनेंट उस वाहन को अपने अनुमानित रास्ते पर चलते हुए ऐनिमेट करता है.

शिपमेंट की जगह की जानकारी देने वाली कंपनी

शिपमेंट लोकेशन प्रोवाइडर पहले और आखिरी मील शिपमेंट ट्रैकिंग के लिए, ट्रैक किए गए ऑब्जेक्ट की जगह की जानकारी शिपमेंट ट्रैकिंग मैप में फ़ीड करता है.

इन्हें ट्रैक करने के लिए, शिपमेंट की जगह की जानकारी देने वाली कंपनी का इस्तेमाल किया जा सकता है:

  • किसी शिपमेंट के पिक अप या डिलीवरी की जगह.
  • डिलीवरी करने वाले वाहन की जगह और रास्ता.

ट्रैक किए गए स्थान ऑब्जेक्ट

जगह की जानकारी देने वाली कंपनी, वाहनों और डेस्टिनेशन जैसे ऑब्जेक्ट की जगह को ट्रैक करती है.

गंतव्य स्थान

मंज़िल की जगह वह जगह होती है जहां कोई यात्रा खत्म होती है. शिपमेंट ट्रैकिंग के लिए, यह तय की गई टास्क की जगह है.

वाहन की जगह की जानकारी

वाहन की जगह की जानकारी, किसी वाहन को ट्रैक की गई जगह की जानकारी होती है. इसमें वाहन के लिए रूट शामिल किया जा सकता है.

पुष्टि करने वाला टोकन फ़ेचर

Fleet Engine में सेव की गई जगह की जानकारी के डेटा के ऐक्सेस को कंट्रोल करने के लिए, आपको अपने सर्वर पर Fleet Engine के लिए, JSON वेब टोकन (JWT) मिंटिंग सेवा लागू करनी होगी. इसके बाद, जगह की जानकारी के ऐक्सेस की पुष्टि करने के लिए, JavaScript Journey शेयर करने की लाइब्रेरी का इस्तेमाल करके, अपने वेब ऐप्लिकेशन के हिस्से के तौर पर पुष्टि करने वाला टोकन फ़ेचर लागू करें.

स्टाइल के विकल्प

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

ट्रैक की गई जगहों की जानकारी कंट्रोल करना

यह सेक्शन, मैप पर ट्रैक किए गए ऑब्जेक्ट के 'किसको दिखे' सेटिंग के बारे में बताता है. ये नियम ऑब्जेक्ट की दो कैटगरी पर लागू होते हैं:

  • जगह का मार्कर
  • टास्क का डेटा

लोकेशन मार्कर किसको दिखे

शुरुआत की जगह और मंज़िल के लिए सभी जगह मार्कर, मैप पर हमेशा दिखाए जाते हैं. उदाहरण के लिए, डिलीवरी की स्थिति चाहे जो भी हो, मैप पर डिलीवरी की जगह हमेशा दिखती है.

टास्क का डेटा किसे दिखे

इस सेक्शन में टास्क के डेटा पर लागू होने वाले, 'किसको दिखे' के डिफ़ॉल्ट नियमों के बारे में बताया गया है. जैसे, वाहन की जगह और बाकी रास्ता. कई टास्क को अपनी पसंद के मुताबिक बनाया जा सकता है, लेकिन सभी को नहीं:

  • अनुपलब्ध कार्य -- आप इन कार्यों के लिए दृश्यता को कस्टमाइज़ नहीं कर सकते.
  • वाहन के सक्रिय टास्क -- आप इस तरह के टास्क को पसंद के मुताबिक बना सकते हैं.
  • वाहन के काम न करने वाले टास्क -- आप इन टास्क के लिए, दिखाई देने की सुविधा को पसंद के मुताबिक नहीं बना सकते.

ऐसे टास्क जो उपलब्ध नहीं हैं

अगर ट्रैक किए जा रहे रास्ते में कोई एक ऐसा टास्क है जो उपलब्ध नहीं है (उदाहरण के लिए, अगर ड्राइवर ब्रेक ले रहा है या वाहन में ईंधन भरा जा रहा है), तो वाहन नहीं दिखेगा. पहुंचने का अनुमानित समय और टास्क पूरा करने का अनुमानित समय अब भी उपलब्ध है.

वाहन से जुड़े चालू टास्क

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

  • रास्ते की पॉलीलाइन
  • पहुंचने का अनुमानित समय
  • टास्क पूरा होने में लगने वाला अनुमानित समय
  • टास्क तक पहुंचने के लिए, ड्राइविंग से बाकी दूरी तय करें
  • शेष स्टॉप की संख्या
  • वाहन की जगह की जानकारी

Fleet Engine में टास्क बनाते या अपडेट करते समय, टास्क पर TaskTrackingViewConfig को सेट करके, हर टास्क के हिसाब से विज़िबिलिटी कॉन्फ़िगरेशन को अपनी पसंद के मुताबिक बनाया जा सकता है. इससे अलग-अलग डेटा एलिमेंट के उपलब्ध होने के नियम बनते हैं, जो नीचे दी गई शर्तों (इसे नीचे 'किसको दिखे' विकल्प के तौर पर बताया गया है) पर आधारित हो सकते हैं:

  • शेष स्टॉप की संख्या
  • पहुंचने के अनुमानित समय तक
  • ड्राइविंग की शेष दूरी
  • हमेशा दिखेगा
  • कभी भी दृश्यमान नहीं

ध्यान दें कि हर डेटा एलिमेंट को सिर्फ़ एक 'किसको दिखे' विकल्प से जोड़ा जा सकता है. OR या AND का इस्तेमाल करके शर्तों को जोड़ा नहीं जा सकता.

कस्टमाइज़ेशन का एक उदाहरण इस तरह है. उस कस्टमाइज़ेशन के नियम ये हैं:

  • अगर वाहन तीन स्टॉप के अंदर है, तो रास्ते की पॉलीलाइन दिखाएं.
  • अगर ड्राइविंग की दूरी 5,000 मीटर से कम है, तो ETA दिखाएं.
  • शेष स्टॉप की संख्या कभी ना दिखाएं.
  • हर दूसरा फ़ील्ड, डिफ़ॉल्ट रूप से तब दिखता है, जब वाहन, टास्क के पांच स्टॉप के अंदर होता है.
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

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

रूट की पॉलीलाइन और वाहन की जगह की जानकारी देखने के नियम:

रास्ते की पॉलीलाइन दिखने पर, वाहन की जगह की जानकारी भी दिखनी चाहिए. अन्य मामलों में, पॉलीलाइन के आखिर में वाहन की जगह की जानकारी दी जा सकती है. इसका मतलब है कि रास्ते की पॉलीलाइन में कम पाबंदी वाला दिखने का विकल्प नहीं हो सकता.

इन नियमों का पालन करना ज़रूरी है, ताकि रास्तों की मान्य पॉलीलाइन / वाहन की जगह की जानकारी का कॉम्बिनेशन दिया जा सके:

  • जब रास्ते की पॉलीलाइन और वाहन की जगह पर दिखने का विकल्प एक ही हो तो:

    • अगर 'किसको दिखे' विकल्प, स्टॉप की गिनती, ईटीए तक की अवधि या ड्राइविंग की दूरी बाकी है, तो रूट पॉलीलाइन की वैल्यू, वाहन की जगह के लिए, 'किसको दिखे' सेटिंग के लिए सेट की गई वैल्यू से कम या उसके बराबर होनी चाहिए. इसका एक उदाहरण यह है:
    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
    
    • अगर रास्ते की पॉलीलाइन में 'किसको दिखे' का विकल्प हमेशा दिखता है, तो वाहन की जगह की जानकारी भी दिखनी चाहिए.
    • अगर वाहन की जगह की जानकारी दिखने का विकल्प नहीं है, तो रास्ते की पॉलीलाइन भी दिखना चाहिए. यह विकल्प, रास्ते की जानकारी को कभी न दिखने का विकल्प भी देता है.
  • अगर रास्ते की पॉलीलाइन और वाहन की जगह के लिए अलग-अलग 'किसको दिखे' विकल्प हों, तो वाहन की जगह सिर्फ़ तब दिखती है, जब उनके दिखने के दोनों विकल्प उपलब्ध हों.

    इसका एक उदाहरण यह है:

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingDrivingDistanceMetersThreshold": 3000
      },
    }
    

    इस उदाहरण में, वाहन की जगह सिर्फ़ तब दिखेगी, जब बाकी स्टॉप की संख्या कम से कम तीन हो और बाकी ड्राइविंग दूरी कम से कम 3,000 मीटर हो.

'JavaScript का अनुभव शेयर करने की लाइब्रेरी' का इस्तेमाल शुरू करना

JavaScript Journey शेयर करने की लाइब्रेरी का इस्तेमाल करने से पहले, पक्का करें कि आप Fleet Engine के बारे में और एपीआई कुंजी पाने के बारे में जानते हैं.

डिलीवरी को ट्रैक करने के लिए, सबसे पहले ट्रैकिंग आईडी का दावा करें.

ट्रैकिंग आईडी का दावा बनाना

शिपिंग की जगह की जानकारी देने वाली कंपनी का इस्तेमाल करके, शिपमेंट को ट्रैक करने के लिए, ट्रैकिंग आईडी के दावे के साथ JSON Web Token (JWT) बनाएं.

JWT पेलोड बनाने के लिए, अनुमति देने वाले सेक्शन में कुंजी trackingid के साथ एक और दावा जोड़ें. शिपमेंट ट्रैकिंग आईडी पर इसकी वैल्यू सेट करें.

यहां दिए गए उदाहरण में, ट्रैकिंग आईडी की मदद से ट्रैकिंग के लिए टोकन बनाने का तरीका बताया गया है:

{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "private_key_id_of_consumer_service_account"
}
.
{
  "iss": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "sub": "consumer@yourgcpproject.iam.gserviceaccount.com",
  "aud": "https://fleetengine.googleapis.com/",
  "iat": 1511900000,
  "exp": 1511903600,
  "scope": "https://www.googleapis.com/auth/xapi",
  "authorization": {
     "trackingid": "tid_54321",
   }
}

पुष्टि करने वाला टोकन फ़ेचर बनाएं

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

फ़ेचर को प्रॉमिस में रैप किए गए दो फ़ील्ड के साथ डेटा स्ट्रक्चर दिखाना होगा:

  • स्ट्रिंग token.
  • नंबर expiresInSeconds. फ़ेच करने के बाद इतने समय में टोकन खत्म हो जाता है.

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

  • इसमें मान्य टोकन नहीं होता है, जैसे कि जब इसने हाल ही के पेज लोड पर फ़ेचर को कॉल नहीं किया है या जब फ़ेचर कोई टोकन नहीं देता है.
  • इसे पहले फ़ेच किए गए टोकन की समयसीमा खत्म हो गई है.
  • इससे पहले जो टोकन फ़ेच किया गया था उसकी समयसीमा खत्म होने के एक मिनट के अंदर का समय है.

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

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

JavaScript

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.expiration_timestamp_ms - Date.now(),
  };
}

टोकन इकट्ठा करने के लिए सर्वर-साइड एंडपॉइंट लागू करते समय, इन बातों को ध्यान में रखें:

  • यह ज़रूरी है कि एंडपॉइंट से, टोकन की समयसीमा खत्म होने का समय दिखाया जाए. ऊपर दिए गए उदाहरण में, यह data.ExpiresInSeconds के तौर पर दिखाया गया है.
  • पुष्टि करने वाले टोकन फ़ेचर को लाइब्रेरी में, डेटा फ़ेच करने की समयसीमा खत्म होने का समय (सेकंड में) पास करना होगा, जैसा कि उदाहरण में दिखाया गया है.
  • SERVER_TOKEN_URL, आपके बैकएंड को लागू करने के तरीके पर निर्भर करता है. ये सैंपल ऐप्लिकेशन बैकएंड के यूआरएल हैं:
    • https://SERVER_URL/token/delivery_driver/DELIVERY_VEHICLE_ID
    • https://SERVER_URL/token/delivery_consumer/TRACKING_ID
    • https://SERVER_URL/token/fleet_reader

एचटीएमएल से कोई मैप लोड करें

नीचे दिए गए उदाहरण में, किसी खास यूआरएल से JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी को लोड करने का तरीका बताया गया है. एपीआई लोड होने के बाद, callback पैरामीटर initMap फ़ंक्शन एक्ज़ीक्यूट करता है. defer एट्रिब्यूट का इस्तेमाल करके, ब्राउज़र एपीआई के लोड होने के दौरान आपके बाकी पेज को रेंडर करना जारी रखता है.

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>

शिपमेंट को फ़ॉलो करें

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

शिपमेंट की जगह की जानकारी देने वाली कंपनी को इंस्टैंशिएट करें

JavaScript शिपमेंट ट्रैकिंग लाइब्रेरी, Fleet Engine डिलीवरी API के लिए, जगह की जानकारी देने वाली कंपनी की जानकारी देती है. इसे इंस्टैंशिएट करने के लिए, अपने प्रोजेक्ट आईडी और टोकन फ़ैक्ट्री के रेफ़रंस का इस्तेमाल करें.

JavaScript

locationProvider =
    new google.maps.journeySharing
        .FleetEngineShipmentLocationProvider({
          projectId: 'your-project-id',
          authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step

          // Optionally, you may specify tracking ID to
          // immediately start tracking.
          trackingId: 'your-tracking-id',
});

TypeScript

locationProvider =
    new google.maps.journeySharing
        .FleetEngineShipmentLocationProvider({
          projectId: 'your-project-id',
          authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step

          // Optionally, you may specify tracking ID to
          // immediately start tracking.
          trackingId: 'your-tracking-id',
});

मैप व्यू शुरू करना

JavaScript जर्नी शेयरिंग लाइब्रेरी लोड करने के बाद, मैप व्यू शुरू करें और उसे एचटीएमएल पेज में जोड़ें. आपके पेज में <div> एलिमेंट होना चाहिए, जिसमें मैप व्यू हो. नीचे दिए गए उदाहरण में, <div> एलिमेंट को map_canvas नाम दिया गया है.

रेस की शर्तों से बचने के लिए, मैप शुरू होने के बाद शुरू किए गए कॉलबैक में, जगह की जानकारी देने वाले के लिए ट्रैकिंग आईडी सेट करें.

JavaScript

const mapView = new 
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'), 
  locationProviders: [locationProvider],
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
  // Any undefined styling options will use defaults.
});

// If you did not specify a tracking ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.trackingId = 'your-tracking-id';

// Give the map an initial viewport to allow it to 
// initialize; otherwise the 'ready' event above may 
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);

TypeScript

const mapView = new 
    google.maps.journeySharing.JourneySharingMapView({
  document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  vehicleMarkerSetup: vehicleMarkerSetup,
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
 // Any undefined styling options will use defaults.
});

// If you did not specify a tracking ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.trackingId = 'your-tracking-id';

// Give the map an initial viewport to allow it to
// initialize; otherwise the 'ready' event above may 
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);

ट्रैकिंग आईडी

जगह की जानकारी देने वाली कंपनी को दिया गया ट्रैकिंग आईडी, कई टास्क से जुड़ा हो सकता है. उदाहरण के लिए, एक ही पैकेज के लिए पिकअप और डिलीवरी से जुड़े टास्क या डिलीवरी की कई असफल कोशिशें. एक टास्क चुना गया है, जिसे शिपमेंट ट्रैकिंग मैप पर दिखाया जा सकता है. दिखाया जाने वाला टास्क इस तरह तय किया जाता है:

  1. अगर पिकअप करने का कोई एक टास्क मौजूद है, तो वह दिखेगा. अगर पिकअप के लिए बने एक से ज़्यादा टास्क हैं, तो गड़बड़ी का मैसेज जनरेट होगा.
  2. अगर डिलीवर किया जाने वाला सिर्फ़ एक टास्क होता है, तो वह दिखता है. अगर डिलीवरी के कई टास्क हैं, तो गड़बड़ी जनरेट होती है.
  3. अगर क्लोज़्ड डिलीवरी से जुड़े टास्क हैं, तो:
    • अगर डिलीवरी का सिर्फ़ एक टास्क हो, तो वह दिखाया जाता है.
    • अगर क्लोज़्ड डिलीवरी के कई टास्क हैं, तो सबसे हाल की डिलीवरी वाले टास्क को दिखाया जाता है.
    • अगर डिलीवरी के कई टास्क हैं, जिनमें से किसी भी टास्क के लिए तय समयसीमा नहीं है, तो एक गड़बड़ी जनरेट होती है.
  4. अगर पिकअप के टास्क बंद हैं, तो:
    • अगर पिक अप का सिर्फ़ एक टास्क होता है, तो वह दिखता है.
    • अगर पिकअप के कई टास्क हैं, तो सबसे हाल के इनकम समय वाले टास्क को दिखाया जाएगा.
    • अगर पिकअप के कई टास्क हैं और उनमें से किसी भी टास्क के लिए तय समय खत्म नहीं हुआ है, तो गड़बड़ी का मैसेज जनरेट होता है.
  5. ऐसा न होने पर, कोई टास्क नहीं दिखाया जाएगा.

बदलाव के इवेंट सुनना

जगह की जानकारी देने वाली कंपनी का इस्तेमाल करके, टास्क ट्रैकिंग जानकारी ऑब्जेक्ट से किसी टास्क की मेटा जानकारी पाई जा सकती है. मेटा जानकारी में ETA, बचे हुए स्टॉप की संख्या, और पिकअप या डिलीवरी से पहले बची हुई दूरी शामिल होती है. मेटा जानकारी में होने वाले बदलावों से अपडेट इवेंट ट्रिगर होता है. यहां दिए गए उदाहरण में, बदलाव से जुड़े इन इवेंट को सुनने का तरीका बताया गया है.

JavaScript

locationProvider.addListener('update', e => {
  // e.taskTrackingInfo contains data that may be useful
  // to the rest of the UI.
  console.log(e.taskTrackingInfo.remainingStopCount);
});

TypeScript

locationProvider.addListener('update',
    (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
  // e.taskTrackingInfo contains data that may be useful
  // to the rest of the UI.
  console.log(e.taskTrackingInfo.remainingStopCount);
});

गड़बड़ियां ठीक करना

शिपमेंट की जानकारी का अनुरोध करने से एसिंक्रोनस रूप से पैदा होने वाली गड़बड़ियां, गड़बड़ी इवेंट को ट्रिगर करती हैं. नीचे दिए गए उदाहरण में, गड़बड़ियों को ठीक करने के लिए इन इवेंट को सुनने का तरीका बताया गया है.

JavaScript

locationProvider.addListener('error', e => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

TypeScript

locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

ध्यान दें: अगर आपको इस बात की जानकारी नहीं है कि गड़बड़ियों को ठीक करना है, तो try...catch ब्लॉक में लाइब्रेरी कॉल को रैप करना न भूलें.

ट्रैकिंग रोकें

जगह की जानकारी देने वाली कंपनी को शिपमेंट ट्रैक करने से रोकने के लिए, जगह की जानकारी देने वाली कंपनी से ट्रैकिंग आईडी हटाएं.

JavaScript

locationProvider.trackingId = '';

TypeScript

locationProvider.trackingId = '';

मैप व्यू से, जगह की जानकारी देने वाली कंपनी को हटाएं

नीचे दिए गए उदाहरण में, मैप व्यू से जगह की जानकारी देने वाली कंपनी को हटाने का तरीका बताया गया है.

JavaScript

mapView.removeLocationProvider(locationProvider);

TypeScript

mapView.removeLocationProvider(locationProvider);

बुनियादी मैप के रंग-रूप को पसंद के मुताबिक बनाएं

मैप कॉम्पोनेंट के लुक को पसंद के मुताबिक बनाने के लिए, क्लाउड-आधारित टूल का इस्तेमाल करके या सीधे कोड में विकल्प सेट करके, अपने मैप की स्टाइल बदलें.

क्लाउड-आधारित मैप स्टाइल का इस्तेमाल करना

क्लाउड-आधारित मैप की स्टाइल से, आपको Google Cloud कंसोल से Google Maps का इस्तेमाल करने वाले अपने सभी ऐप्लिकेशन के लिए, मैप स्टाइल बनाने और उनमें बदलाव करने की सुविधा मिलती है. इसके लिए, आपको कोड में कोई बदलाव करने की ज़रूरत नहीं होती. मैप की स्टाइल, आपके Cloud प्रोजेक्ट में मैप आईडी के तौर पर सेव की जाती हैं. अपने JavaScript शिपमेंट ट्रैकिंग मैप पर कोई स्टाइल लागू करने के लिए, JourneySharingMapView बनाते समय mapId डालें. JourneySharingMapView को इंस्टैंशिएट करने के बाद, mapId फ़ील्ड को बदला या जोड़ा नहीं जा सकता. यहां दिए गए उदाहरण में, पहले बनाए गए मैप स्टाइल को मैप आईडी के साथ चालू करने का तरीका बताया गया है.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

कोड पर आधारित मैप स्टाइलिंग का इस्तेमाल करना

मैप की स्टाइल को पसंद के मुताबिक बनाने का एक और तरीका है, JourneySharingMapView बनाते समय mapOptions को सेट करना.

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

मार्कर कस्टमाइज़ेशन का इस्तेमाल करना

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

सबसे आसान पसंद के मुताबिक बनाने के लिए, ऐसा MarkerOptions ऑब्जेक्ट तय करना है जिसे एक ही तरह के सभी मार्कर पर लागू किया जाएगा. ऑब्जेक्ट में बताए गए बदलाव, हर मार्कर बनाने के बाद लागू होते हैं. साथ ही, ये बदलाव किसी भी डिफ़ॉल्ट विकल्प को ओवरराइट कर देते हैं.

कस्टम फ़ंक्शन के बारे में बताना ज़्यादा बेहतर विकल्प है. कस्टमाइज़ेशन फ़ंक्शन की मदद से, डेटा के आधार पर मार्कर की स्टाइल बनाई जा सकती है. साथ ही, क्लिक हैंडलिंग जैसे मार्कर में इंटरैक्टिविटी जोड़ी जा सकती है. खास तौर पर, शिपमेंट ट्रैकिंग, कस्टमाइज़ेशन फ़ंक्शन को डेटा भेजती है. इसमें यह जानकारी होती है कि मार्कर, किस तरह के ऑब्जेक्ट को दिखाता है: वाहन या डेस्टिनेशन. इससे मार्कर की स्टाइल को मार्कर एलिमेंट की मौजूदा स्थिति के आधार पर बदलने की अनुमति मिलती है. उदाहरण के लिए, मंज़िल तक पहुंचने तक, तय किए गए कितने स्टॉप बचे हैं. Fleet Engine के बाहर के सोर्स से भी डेटा को जोड़ा जा सकता है और उस जानकारी के आधार पर मार्कर को स्टाइल किया जा सकता है.

शिपमेंट ट्रैकिंग लाइब्रेरी, FleetEngineShipmentLocationProviderOptions में ये कस्टमाइज़ेशन पैरामीटर उपलब्ध कराती है:

MarkerOptions का उपयोग करके मार्कर की शैली बदलें

यहां दिए गए उदाहरण में, MarkerOptions ऑब्जेक्ट के साथ वाहन के मार्कर की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. ऊपर दिए गए किसी भी मार्कर कस्टमाइज़ेशन का इस्तेमाल करके, किसी भी मार्कर की स्टाइल को पसंद के मुताबिक बनाने के लिए इस पैटर्न का पालन करें.

JavaScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

कस्टमाइज़ेशन फ़ंक्शन का इस्तेमाल करके मार्कर की स्टाइल बदलें

नीचे दिए गए उदाहरण में, वाहन के मार्कर की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. किसी भी मार्कर की स्टाइल को पसंद के मुताबिक बनाने के लिए, इस पैटर्न का पालन करें. इसके लिए, ऊपर दिए गए किसी भी मार्कर कस्टम पैरामीटर का इस्तेमाल करें.

JavaScript

deliveryVehicleMarkerCustomization =
  (params) => {
    var stopsLeft = params.taskTrackingInfo.remainingStopCount;
    params.marker.setLabel(`${stopsLeft}`);
  };

TypeScript

deliveryVehicleMarkerCustomization =
  (params: ShipmentMarkerCustomizationFunctionParams) => {
    const stopsLeft = params.taskTrackingInfo.remainingStopCount;
    params.marker.setLabel(`${stopsLeft}`);
  };

मार्कर में क्लिक हैंडलिंग जोड़ें

नीचे दिए गए उदाहरण में, वाहन के मार्कर में क्लिक हैंडलिंग जोड़ने का तरीका बताया गया है. ऊपर दिए गए किसी भी मार्कर कस्टमाइज़ेशन पैरामीटर का इस्तेमाल करके, किसी भी मार्कर में क्लिक हैंडलिंग जोड़ने के लिए इस पैटर्न का पालन करें.

JavaScript

deliveryVehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

deliveryVehicleMarkerCustomization =
  (params: ShipmentMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

पॉलीलाइन कस्टमाइज़ेशन का इस्तेमाल करना

शिपमेंट ट्रैकिंग लाइब्रेरी की मदद से, मैप पर शिपमेंट के रास्ते के लुक और लुक को पसंद के मुताबिक बनाया जा सकता है. लाइब्रेरी, शिपमेंट के चालू या बचे हुए पाथ में, कोऑर्डिनेट के हर जोड़े के लिए एक google.maps.Polyline ऑब्जेक्ट बनाती है. पॉलीलाइन कस्टमाइज़ेशन के बारे में बताकर, Polyline ऑब्जेक्ट को स्टाइल किया जा सकता है. इसके बाद, लाइब्रेरी इन कस्टमाइज़ेशन को दो स्थितियों में लागू करती है: मैप पर ऑब्जेक्ट जोड़ने से पहले, और ऑब्जेक्ट के लिए इस्तेमाल किए गए डेटा में बदलाव होने से पहले.

मार्कर को पसंद के मुताबिक बनाने की तरह ही, PolylineOptions का एक सेट तय किया जा सकता है, जो मेल खाने वाले सभी Polyline ऑब्जेक्ट पर तब लागू होगा, जब उन्हें बनाया या अपडेट किया जाएगा.

इसी तरह, कस्टमाइज़ेशन फ़ंक्शन तय किया जा सकता है. कस्टमाइज़ेशन फ़ंक्शन, Fleet Engine से मिले डेटा के आधार पर, ऑब्जेक्ट को अलग-अलग स्टाइल में बदलने की सुविधा देते हैं. यह फ़ंक्शन, शिपमेंट की मौजूदा स्थिति के हिसाब से हर ऑब्जेक्ट की स्टाइल बदल सकता है. जैसे, Polyline ऑब्जेक्ट को गहरे रंग में दिखाना या वाहन के धीमे चलने पर उसे मोटा बनाना. आप चाहें, तो Fleet Engine के बाहर के सोर्स से भी मीटिंग में शामिल हुआ जा सकता है और उस जानकारी के आधार पर Polyline ऑब्जेक्ट को स्टाइल किया जा सकता है.

FleetEngineShipmentLocationProviderOptions में दिए गए पैरामीटर का इस्तेमाल करके, कस्टमाइज़ेशन के बारे में बताया जा सकता है. आप वाहन की यात्रा के दौरान, पाथ की अलग-अलग स्थितियों के हिसाब से मनमुताबिक बदलाव करने की सुविधा सेट कर सकते हैं--वे पहले ही यात्रा कर चुके हैं, सक्रिय रूप से यात्रा कर चुके हैं या अभी तक यात्रा नहीं कर चुके हैं. पैरामीटर नीचे दिए गए हैं:

PolylineOptions का इस्तेमाल करके, Polyline ऑब्जेक्ट की स्टाइल बदलें

यहां दिए गए उदाहरण में, PolylineOptions वाले Polyline ऑब्जेक्ट की स्टाइलिंग को कॉन्फ़िगर करने का तरीका बताया गया है. किसी भी Polyline ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाने के लिए, इस पैटर्न को अपनाएं. इसके लिए, ऊपर बताए गए किसी भी पॉलीलाइन कस्टमाइज़ेशन का इस्तेमाल करें.

JavaScript

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

TypeScript

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

पसंद के मुताबिक बनाने के फ़ंक्शन का इस्तेमाल करके, Polyline ऑब्जेक्ट की स्टाइल बदलें

इस उदाहरण में, चालू Polyline ऑब्जेक्ट की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. इस पैटर्न को फ़ॉलो करके, किसी भी Polyline ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाएं. इसके लिए, ऊपर दिए गए किसी भी पॉलीलाइन कस्टम पैरामीटर का इस्तेमाल करें.

JavaScript

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params) => {
    const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
    if (distance < 1000) {

      // params.polylines contains an ordered list of Polyline objects for
      // the path.
      for (const polylineObject of params.polylines) {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

TypeScript

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params: ShipmentPolylineCustomizationFunctionParams) => {
    const distance = params.taskTrackingInfo.remainingDrivingDistanceMeters;
    if (distance < 1000) {

      // params.polylines contains an ordered list of Polyline objects for
      // the path.
      for (const polylineObject of params.polylines) {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

कंट्रोल करें कि Polyline ऑब्जेक्ट किसको दिखे

डिफ़ॉल्ट रूप से, सभी Polyline ऑब्जेक्ट दिखते हैं. किसी Polyline ऑब्जेक्ट को न दिखाने के लिए, उसकी visible प्रॉपर्टी को सेट करें:

JavaScript

remainingPolylineCustomization = {visible: false};

TypeScript

remainingPolylineCustomization = {visible: false};

वाहन या जगह के मार्कर के लिए InfoWindow दिखाएं

किसी वाहन या जगह के मार्कर के बारे में ज़्यादा जानकारी दिखाने के लिए, InfoWindow का इस्तेमाल किया जा सकता है.

नीचे दिए गए उदाहरण में, InfoWindow बनाने और उसे वाहन के मार्कर से अटैच करने का तरीका बताया गया है:

JavaScript

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

locationProvider.addListener('update', e => {
  const stopsCount =
      e.taskTrackingInfo.remainingStopCount;
  infoWindow.setContent(
      `Your vehicle is ${stopsCount} stops away.`);

  // 2. Attach the info window to a vehicle marker.
  // This property can return multiple markers.
  const marker = mapView.vehicleMarkers[0];
  infoWindow.open(mapView.map, marker);
});

// 3. Close the info window.
infoWindow.close();

TypeScript

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
  const stopsCount =
      e.taskTrackingInfo.remainingStopCount;
  infoWindow.setContent(
      `Your vehicle is ${stopsCount} stops away.`);

  // 2. Attach the info window to a vehicle marker.
  // This property can return multiple markers.
  const marker = mapView.vehicleMarkers[0];
  infoWindow.open(mapView.map, marker);
});

// 3. Close the info window.
infoWindow.close();

अपने-आप फ़िट होने की सुविधा बंद करें

अपने-आप फ़िट होने की सुविधा को बंद करके, मैप को व्यूपोर्ट में अपने-आप फ़िट होने से रोका जा सकता है और अनुमानित रास्ते को रोका जा सकता है. नीचे दिए गए उदाहरण में बताया गया है कि यात्रा की जानकारी शेयर करने वाले मैप व्यू को कॉन्फ़िगर करते समय, अपने-आप फ़िट होने की सुविधा को कैसे बंद किया जाए.

JavaScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

TypeScript

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
  const stopsCount =
      e.taskTrackingInfo.remainingStopCount;
  infoWindow.setContent(
      `Your vehicle is ${stopsCount} stops away.`);

  // 2. Attach the info window to a vehicle marker.   
  // This property can return multiple markers.
  const marker = mapView.vehicleMarkers[0];
  infoWindow.open(mapView.map, marker);
});

// 3. Close the info window.
infoWindow.close();

कोई मौजूदा मैप बदलें

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

उदाहरण के लिए, मान लें कि आपके पास मानक google.maps.Map इकाई वाला एक वेब पेज है, जिस पर मार्कर दिखाया जाता है:

<!DOCTYPE html>
<html>
  <head>
    <style>
       /* Set the size of the div element that contains the map */
      #map {
        height: 400px;  /* The height is 400 pixels */
        width: 100%;  /* The width is the width of the web page */
       }
    </style>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>
    <script>
// Initialize and add the map
function initMap() {
  // The location of Uluru
  var uluru = {lat: -25.344, lng: 131.036};
  // The map, initially centered at Mountain View, CA.
  var map = new google.maps.Map(document.getElementById('map'));
  map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});

  // The marker, now positioned at Uluru
  var marker = new google.maps.Marker({position: uluru, map: map});
}
    </script>
    <!-- Load the API from the specified URL.
       * The async attribute allows the browser to render the page while the API loads.
       * The key parameter will contain your own API key (which is not needed for this tutorial).
       * The callback parameter executes the initMap() function.
    -->
    <script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  </body>
</html>

'JavaScript का सफ़र' शेयर करने की लाइब्रेरी जोड़ने के लिए:

  1. पुष्टि करने वाले टोकन की फ़ैक्ट्री के लिए कोड जोड़ें.
  2. initMap() फ़ंक्शन में जगह की जानकारी देने वाली कंपनी को शुरू करें.
  3. initMap() फ़ंक्शन में मैप व्यू को शुरू करें. इस व्यू में मैप शामिल है.
  4. मैप व्यू शुरू करने के लिए, अपनी पसंद के मुताबिक बनाने की सुविधा को कॉलबैक फ़ंक्शन में ले जाएं.
  5. एपीआई लोडर में, जगह की जानकारी वाली लाइब्रेरी जोड़ें.

नीचे दिए गए उदाहरण में, किए जाने वाले बदलाव दिखाए गए हैं:

<!DOCTYPE html>
<html>
  <head>
    <style>
       /* Set the size of the div element that contains the map */
      #map {
        height: 400px;  /* The height is 400 pixels */
        width: 100%;  /* The width is the width of the web page */
       }
    </style>
  </head>
  <body>
    <h3>My Google Maps Demo</h3>
    <!--The div element for the map -->
    <div id="map"></div>
    <script>
let locationProvider;

// (1) Authentication Token Fetcher
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
      };
}

// Initialize and add the map
function initMap() {
  // (2) Initialize location provider.
  locationProvider = new google.maps.journeySharing.FleetEngineShipmentLocationProvider({
    YOUR_PROVIDER_ID,
    authTokenFetcher,
  });

  // (3) Initialize map view (which contains the map).
  const mapView = new google.maps.journeySharing.JourneySharingMapView({
    element: document.getElementById('map'),
    locationProviders: [locationProvider],
    // any styling options
  });

  locationProvider.trackingId = TRACKING_ID;

    // (4) Add customizations like before.

    // The location of Uluru
    var uluru = {lat: -25.344, lng: 131.036};
    // The map, initially centered at Mountain View, CA.
    var map = mapView.map;
    map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
    // The marker, now positioned at Uluru
    var marker = new google.maps.Marker({position: uluru, map: map});
  };

    </script>
    <!-- Load the API from the specified URL
      * The async attribute allows the browser to render the page while the API loads
      * The key parameter will contain your own API key (which is not needed for this tutorial)
      * The callback parameter executes the initMap() function
      *
      * (5) Add the journey sharing library to the API loader.
    -->
    <script defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing">
    </script>
  </body>
</html>

अगर आपके पास Ulura के पास ट्रैक किया गया कोई आईडी है, जिसमें बताए गए आईडी का इस्तेमाल किया गया है, तो उसे अब मैप पर रेंडर कर दिया जाएगा.