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

JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी की मदद से, करीब-करीब रीयल टाइम में अपने बेड़े में मौजूद वाहनों की जगह को विज़ुअलाइज़ किया जा सकता है. लाइब्रेरी में, वाहनों और यात्राओं की जानकारी को विज़ुअलाइज़ करने के लिए, मांग पर राइड और डिलीवरी के लिए एपीआई का इस्तेमाल किया जाता है. JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी में एक JavaScript मैप कॉम्पोनेंट होता है, जो फ़्लीट इंजन से कनेक्ट करने के लिए स्टैंडर्ड google.maps.Map इकाई और डेटा कॉम्पोनेंट का ड्रॉप-इन रिप्लेसमेंट होता है.

घटक

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

फ़्लीट ट्रैकिंग मैप व्यू

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

जगह की जानकारी देने वाली कंपनियां

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

वाहन की जगह की जानकारी देने वाली कंपनी

वाहन की जगह की जानकारी देने वाला संगठन, एक वाहन की जगह की जानकारी दिखाता है. इसमें, वाहन की जगह और वाहन को असाइन की गई मौजूदा यात्रा की जानकारी होती है.

फ़्लीट लोकेशन प्रोवाइडर

फ़्लीट की जगह की जानकारी देने वाली कंपनी, कई गाड़ियों की जगह की जानकारी दिखाती है. किसी वाहन और उसकी जगह की जानकारी को फ़िल्टर करके देखा जा सकता है या पूरे फ़्लीट के लिए वाहन की जगह की जानकारी दिखाई जा सकती है.

ट्रैक की गई जगहों की जानकारी दिखाने को कंट्रोल करें

'किसको दिखे' सेटिंग से यह तय होता है कि फ़्लीट इंजन की लोकेशन उपलब्ध कराने वाले के लिए, मैप पर ट्रैक किया गया लोकेशन ऑब्जेक्ट कब दिखेगा. नोट - किसी कस्टम या व्युत्पन्न स्थान कंपनी का उपयोग करने से दृश्यता नियम बदल सकते हैं.

गाड़ियां

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

वेपॉइंट लोकेशन मार्कर

वेपॉइंट लोकेशन मार्कर, वाहन की यात्रा के उन पॉइंट को दिखाता है जो शुरुआत की जगह से शुरू होते हैं और आखिरी मंज़िल पर खत्म होते हैं. वेपॉइंट लोकेशन मार्कर को इस तरह परिभाषित किया जा सकता है:

• शुरुआत की जगह - वाहन की यात्रा शुरू करने की जगह बताती है
• इंटरमीडिएट - वाहन यात्रा के स्टॉपओवर की जानकारी देता है
• गंतव्य - वाहन यात्रा के लिए अंतिम स्थान दिखाता है

वाहन के लिए तय किए गए वेपॉइंट, मैप पर ऑरिजिन, इंटरमीडिएट, और डेस्टिनेशन मार्कर के तौर पर दिखाए जाते हैं.

JavaScript फ़्लीट ट्रैकिंग लाइब्रेरी का इस्तेमाल करना शुरू करें

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

यात्रा का आईडी और वाहन के आईडी पर दावा करें

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

JWT पेलोड बनाने के लिए, अनुमति देने वाले सेक्शन में tripid और vehicleid कुंजियों के साथ अतिरिक्त दावा जोड़ें. साथ ही, हर कुंजी के value को * पर सेट करें. टोकन को फ़्लीट इंजन सर्विस सुपर यूज़र क्लाउड आईएएम रोल का इस्तेमाल करके बनाया जाना चाहिए. ध्यान दें कि इससे फ़्लीट इंजन की इकाइयां बनाने, पढ़ने, और उनमें बदलाव करने की अनुमति मिलती है. साथ ही, इसे सिर्फ़ भरोसेमंद लोगों के साथ शेयर किया जाना चाहिए.

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

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

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

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

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

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

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

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

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

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

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

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/driver/VEHICLE_ID
  • https://SERVER_URL/token/consumer/TRIP_ID
  • https://SERVER_URL/token/fleet_reader

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

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

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

वाहन फ़ॉलो करें

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

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

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

locationProvider =
    new google.maps.journeySharing
        .FleetEngineVehicleLocationProvider({
          projectId,
          authTokenFetcher,

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

locationProvider =
    new google.maps.journeySharing
        .FleetEngineVehicleLocationProvider({
          projectId,
          authTokenFetcher,

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

मैप व्यू शुरू करें

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

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

// If you did not specify a vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.vehicleId
                        = 'your-vehicle-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('Times Square, New York, NY');
mapView.map.setZoom(14);

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

// If you did not specify a vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.vehicleId = 'your-vehicle-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('Times Square, New York, NY');
mapView.map.setZoom(14);

बदलाव से जुड़े इवेंट सुनना

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

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

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

गड़बड़ियां सुनें

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

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

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

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

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

locationProvider.vehicleId = '';

locationProvider.vehicleId = '';

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

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

mapView.removeLocationProvider(locationProvider);

mapView.removeLocationProvider(locationProvider);

वाहन का फ़्लीट देखें

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

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

JavaScript Fleet Tracking Library पहले से, लोकेशन प्रोवाइडर के बारे में जानकारी दी जाती है. यह ऐसी जगह है जो On Demand Rides and Deliveryies API से कई गाड़ियां फ़ेच करती है. इसे इंस्टैंशिएट करने के लिए, अपने प्रोजेक्ट आईडी और टोकन फ़ेचर के रेफ़रंस का इस्तेमाल करें.

locationProvider =
    new google.maps.journeySharing
        .FleetEngineFleetLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, specify location bounds to
          // limit which vehicles are
          // retrieved and immediately start tracking.
          locationRestriction: {
            north: 37.3,
            east: -121.8,
            south: 37.1,
            west: -122,
          },
          // Optionally, specify a filter to limit
          // which vehicles are retrieved.
          vehicleFilter:
            'attributes.foo = "bar" AND attributes.baz = "qux"',
        });

locationProvider =
    new google.maps.journeySharing
        .FleetEngineFleetLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, specify location bounds to
          // limit which vehicles are
          // retrieved and immediately start tracking.
          locationRestriction: {
            north: 37.3,
            east: -121.8,
            south: 37.1,
            west: -122,
          },
          // Optionally, specify a filter to limit
          // which vehicles are retrieved.
          vehicleFilter:
            'attributes.foo = "bar" AND attributes.baz = "qux"',
        });

vehicleFilter ऐसी क्वेरी के बारे में बताता है जिसका इस्तेमाल, मैप पर दिखाए गए वाहनों को फ़िल्टर करने के लिए किया जाता है. यह फ़िल्टर सीधे Fleet Engine को पास किया जाता है. इस्तेमाल किए जा सकने वाले फ़ॉर्मैट के लिए, ListVehiclesRequest पर जाएं.

locationRestriction उस इलाके को सीमित करता है जहां मैप पर वाहन दिखाना है. इससे यह भी कंट्रोल किया जाता है कि जगह की जानकारी ट्रैक करने की सुविधा चालू है या नहीं. जब तक इसे सेट नहीं किया जाता, तब तक जगह की ट्रैकिंग शुरू नहीं होगी.

जगह की जानकारी देने वाला टूल बन जाने के बाद, मैप व्यू शुरू करें.

मैप व्यूपोर्ट का इस्तेमाल करके जगह की पाबंदी सेट करें

मैप व्यू में दिख रहे इलाके से मैच करने के लिए, locationRestriction के बाउंड को कॉन्फ़िगर किया जा सकता है.

google.maps.event.addListenerOnce(
  mapView.map, 'bounds_changed', () => {
    const bounds = mapView.map.getBounds();
    if (bounds) {
      // If you did not specify a location restriction in the
      // location provider constructor, you may do so here.
      // Location tracking will start as soon as this is set.
      locationProvider.locationRestriction = bounds;
    }
  });

google.maps.event.addListenerOnce(
  mapView.map, 'bounds_changed', () => {
    const bounds = mapView.map.getBounds();
    if (bounds) {
      // If you did not specify a location restriction in the
      // location provider constructor, you may do so here.
      // Location tracking will start as soon as this is set.
      locationProvider.locationRestriction = bounds;
    }
  });

बदलाव से जुड़े इवेंट सुनना

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

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

locationProvider.addListener('update',
    (e: google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent) => {
  // e.vehicles contains data that may be useful to the rest of the UI.
  if (e.vehicles) {
    for (vehicle of e.vehicles) {
      console.log(vehicle.navigationStatus);
    }
  }
});

गड़बड़ियां सुनें

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

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

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

locationProvider.locationRestriction = null;

locationProvider.locationRestriction = null;

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

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

mapView.removeLocationProvider(locationProvider);

mapView.removeLocationProvider(locationProvider);

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

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

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

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

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

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

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

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

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

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 के बाहर के सोर्स के डेटा से भी जॉइन किया जा सकता है और उस जानकारी के आधार पर मार्कर की स्टाइल तय की जा सकती है.

इसके अलावा, मार्कर की विज़िबिलिटी को फ़िल्टर करने के लिए, कस्टमाइज़ेशन फ़ंक्शन का इस्तेमाल किया जा सकता है. ऐसा करने के लिए, मार्कर पर setVisible(false) को कॉल करें.

हालांकि, हमारा सुझाव है कि परफ़ॉर्मेंस को बेहतर बनाने के लिए, लोकेशन प्रोवाइडर में, नेटिव फ़िल्टर का इस्तेमाल करें, जैसे कि FleetEngineFleetLocationProvider.vehicleFilter. हालांकि, जब आपको फ़िल्टर करने के ज़्यादा फ़ंक्शन की ज़रूरत होती है, तो कस्टमाइज़ेशन फ़ंक्शन का इस्तेमाल करके फ़िल्टर करना लागू किया जा सकता है.

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

• FleetEngineVehicleLocationProviderOptions
  • vehicleMarkerCustomization
  • originMarkerCustomization
  • destinationMarkerCustomization
  • intermediateDestinationMarkerCustomization
• FleetEngineFleetLocationProviderOptions
  • vehicleMarkerCustomization

MarkerOptions का इस्तेमाल करके मार्कर की स्टाइल बदलें

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

vehicleMarkerCustomization = {
  cursor: 'grab'
};

vehicleMarkerCustomization = {
  cursor: 'grab'
};

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

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

vehicleMarkerCustomization =
  (params) => {
    var remainingWaypoints = params.vehicle.waypoints.length;
    params.marker.setLabel(`${remainingWaypoints}`);
  };

vehicleMarkerCustomization =
  (params: VehicleMarkerCustomizationFunctionParams) => {
    var remainingWaypoints = params.vehicle.waypoints.length;
    params.marker.setLabel(`${remainingWaypoints}`);
  };

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

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

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

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

दिखने वाले मार्कर को फ़िल्टर करें

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

vehicleMarkerCustomization =
  (params) => {
    var remainingWaypoints = params.vehicle.remainingWaypoints.length;
      if (remainingWaypoints > 10) {
        params.marker.setVisible(false);
      }
  };

vehicleMarkerCustomization =
  (params: VehicleMarkerCustomizationFunctionParams) => {
    var remainingWaypoints = params.vehicle.remainingWaypoints.length;
    if (remainingWaypoints > 10) {
      params.marker.setVisible(false);
    }
  };

वाहन फ़ॉलो करते समय पॉलीलाइन कस्टमाइज़ेशन का इस्तेमाल करें

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

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

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

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

• takenPolylineCustomization, पहले से तय किए गए रास्ते के लिए;
• activePolylineCustomization, यात्रा के दौरान चुने गए रास्ते के लिए;
• remainingPolylineCustomization, उस रास्ते के लिए जिस पर अब तक यात्रा नहीं की गई है.

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

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

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

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

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

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

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params) => {
    const distance = params.vehicle.waypoints[0].distanceMeters;
    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'});
      }
    }
  };

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params: VehiclePolylineCustomizationFunctionParams) => {
    const distance = params.vehicle.waypoints[0].distanceMeters;
    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 प्रॉपर्टी सेट करें:

remainingPolylineCustomization = {visible: false};

remainingPolylineCustomization = {visible: false};

ट्रैफ़िक की जानकारी देने वाले Polyline ऑब्जेक्ट रेंडर करें

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

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineVehicleLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params) => {
    FleetEngineVehicleLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineVehicleLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params: VehiclePolylineCustomizationFunctionParams) => {
    FleetEngineVehicleLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

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

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

इस उदाहरण में, InfoWindow बनाने और उसे वाहन के मार्कर से जोड़ने का तरीका बताया गया है.

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

// (Assumes a vehicle location provider.)
locationProvider.addListener('update', e => {
  if (e.vehicle) {
    const distance =
          e.vehicle.remainingDistanceMeters;
    infoWindow.setContent(
        `Your vehicle is ${distance}m away from the next drop-off point.`);

    // 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();

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

// (Assumes a vehicle location provider.)
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent) => {
  if (e.vehicle) {
    const distance =
          e.vehicle.remainingDistanceMeters;
    infoWindow.setContent(
        `Your vehicle is ${distance}m away from the next drop-off.`);
    // 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();

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

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

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

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

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

आप कोई ऐसा मौजूदा मैप बदल सकते हैं जिसमें मार्कर या अन्य कस्टमाइज़ेशन शामिल हों और ये कस्टमाइज़ेशन खोए बिना.

उदाहरण के लिए, मान लें कि आपके पास स्टैंडर्ड 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 Oracle Park Stadium
        var oraclePark = { lat: 37.780087547237365, lng: -122.38948437884427 };,
        // 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 Oracle Park
        var marker = new google.maps.Marker({ position: oraclePark, 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. Use FleetEngineVehicleLocationProvider
        // as appropriate.
        locationProvider = new google.maps.journeySharing.FleetEngineVehicleLocationProvider({
          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
        });

      mapView.addListener('ready', () => {
        locationProvider.vehicleId = VEHICLE_ID;

          // (4) Add customizations like before.

          // The location of Oracle Park
          var oraclePark = {lat: 37.77995187146094, lng: -122.38957020952795};
          // 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 Oracle Park
          var marker = new google.maps.Marker({position: oraclePark, 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, which includes Fleet Tracking functionality.
    -->
    <script
      defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing&v=beta"
    ></script>
  </body>
</html>

अगर आपके पास Oracle पार्क के पास बताए गए आईडी वाला कोई वाहन है, तो उसे मैप पर दिखाया जाएगा.