इस दस्तावेज़ में, उस मैप के लिए रास्ते की पॉलीलाइन को पसंद के मुताबिक बनाने का तरीका बताया गया है जिसका इस्तेमाल, उपभोक्ता और फ़्लीट ऑपरेटर के लिए, वेब पर आधारित सफ़र ट्रैकिंग ऐप्लिकेशन में किया जाता है.
Consumer SDK टूल की मदद से, रास्ते की पॉलीलाइन को दिखने या मैप पर किसी यात्रा के रास्ते की पॉलीलाइन को स्टाइल करने की सुविधा को कंट्रोल किया जा सकता है. SDK, सफ़र के चालू या बाकी बचे पाथ में, निर्देशांक के हर जोड़े के लिए एक google.maps.Polyline
ऑब्जेक्ट बनाता है. इसके बाद लाइब्रेरी, इन कस्टमाइज़ेशन को
दो स्थितियों में लागू करती है:
- मैप में ऑब्जेक्ट जोड़ने से पहले
- जब ऑब्जेक्ट के लिए इस्तेमाल किए गए डेटा में बदलाव हो
रास्ते की पॉलीलाइन को स्टाइल करना
मार्कर की तरह ही, पसंद के मुताबिक बनाने के पैरामीटर का इस्तेमाल करके, रास्ते की पॉलीलाइन की स्टाइल तय की जा सकती है. इसके बाद, इनमें से किसी एक तरीके का इस्तेमाल करके स्टाइल को कॉन्फ़िगर करें:
- सबसे आसान: मैच होने वाले सभी
Polyline
ऑब्जेक्ट को बनाने या अपडेट करने पर, उन पर लागू करने के लिएPolylineOptions
का इस्तेमाल करें. - बेहतर: कस्टमाइज़ेशन फ़ंक्शन तय करें.
पसंद के मुताबिक बनाने की सुविधाओं की मदद से, Fleet Engine से भेजे गए डेटा के आधार पर, ऑब्जेक्ट की स्टाइल को अलग-अलग बनाया जा सकता है. यह फ़ंक्शन, यात्रा की मौजूदा स्थिति के आधार पर हर ऑब्जेक्ट की स्टाइल बदल सकता है. उदाहरण के लिए,
Polyline
ऑब्जेक्ट को गहरे रंग में रंगना या वाहन के धीरे चलने पर उसे मोटा करना. Fleet Engine के बाहर के सोर्स से भी जॉइन किया जा सकता है और उस जानकारी के आधार परPolyline
ऑब्जेक्ट को स्टाइल किया जा सकता है.
पसंद के मुताबिक बनाने के पैरामीटर
रास्ते की पॉलीलाइन को स्टाइल करते समय, FleetEngineShipmentLocationProviderOptions
में दिए गए पैरामीटर का इस्तेमाल किया जाता है. ये पैरामीटर, वाहन की यात्रा के दौरान पाथ की अलग-अलग स्थितियों की जानकारी देते हैं. इन स्थितियों के बारे में यहां बताया गया है:
- पहले से यात्रा किए गए रास्ते:
takenPolylineCustomization
का इस्तेमाल करें. - अक्सर इस्तेमाल किया जाने वाला पाथ:
activePolylineCustomization
का इस्तेमाल करें. - अभी तक तय नहीं किया गया पाथ:
remainingPolylineCustomization
का इस्तेमाल करें.
PolylineOptions
का इस्तेमाल करें
नीचे दिए गए उदाहरण में, PolylineOptions
की मदद से Polyline
ऑब्जेक्ट के लिए स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. ऊपर दिए गए पॉलीलाइन को पसंद के मुताबिक बनाने के किसी भी तरीके का इस्तेमाल करके, किसी भी Polyline
ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाने के लिए, यह पैटर्न अपनाएं.
JavaScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
रास्ते की पॉलीलाइन को स्टाइल करने के लिए, पसंद के मुताबिक बनाने के फ़ंक्शन का इस्तेमाल करना
यहां दिए गए उदाहरण में, किसी चालू रूट के पॉलीलाइन के लिए स्टाइल कॉन्फ़िगर करने का तरीका बताया गया है. ऊपर दिए गए, रूट पॉलीलाइन को पसंद के मुताबिक बनाने वाले पैरामीटर का इस्तेमाल करके, किसी भी Polyline
ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाने के लिए, इस पैटर्न का पालन करें.
JavaScript
// Color the route 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 route 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
ऑब्जेक्ट को दिखाने के लिए, उसकी visible
प्रॉपर्टी सेट करें:
JavaScript
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};