मार्कर कस्टमाइज़ करें

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

JavaScript Consumer SDK की मदद से, मैप में जोड़े गए दो तरह के मार्कर के लुक और फ़ील को अपनी पसंद के मुताबिक बनाया जा सकता है:

ऐसा करने के दो तरीके हैं:

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

सामान्य उदाहरण: MarkerOptions का इस्तेमाल करना

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

JavaScript

deliveryVehicleMarkerCustomization = {
  opacity: 0.5
};

TypeScript

deliveryVehicleMarkerCustomization = {
  opacity: 0.5
};

ऐडवांस उदाहरण: कस्टम फ़ंक्शन का इस्तेमाल करना

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

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

मार्कर के लिए ज़्यादा जानकारी दिखाना

किसी वाहन या जगह के मार्कर के बारे में ज़्यादा जानकारी दिखाने के लिए, 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();

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