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

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

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

ऐसा करने के लिए, इनमें से कोई एक तरीका अपनाएं:

  • सबसे आसान: एक ही टाइप के सभी मार्कर पर लागू करने के लिए, एक MarkerOptions ऑब्जेक्ट बताएं. इसके बाद, उपभोक्ता 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();

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