इस दस्तावेज़ में, मैप के लुक और फ़ील को पसंद के मुताबिक बनाने का तरीका बताया गया है. साथ ही, इसमें डेटा की विज़िबिलिटी और व्यूपोर्ट के विकल्पों को कंट्रोल करने का तरीका भी बताया गया है. इसके लिए, ये तरीके अपनाए जा सकते हैं:
- क्लाउड पर मैप की स्टाइलिंग की सुविधा का इस्तेमाल करना
- अपने कोड में सीधे मैप की स्टाइल के विकल्प सेट करना
क्लाउड पर मैप की स्टाइलिंग की सुविधा का इस्तेमाल करके, मैप की स्टाइल बदलना
JavaScript की मदद से, उपभोक्ता के सफ़र की जानकारी शेयर करने वाले मैप पर मैप की स्टाइल लागू करने के लिए, JourneySharingMapView बनाते समय,
mapId और
अन्य
mapOptions
की जानकारी दें.
यहां दिए गए उदाहरणों में, मैप आईडी की मदद से मैप की स्टाइल लागू करने का तरीका बताया गया है.
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 बनाते समय, मैप के विकल्प सेट करके भी मैप की स्टाइल को पसंद के मुताबिक बनाया जा सकता है. यहां दिए गए उदाहरणों में, मैप के विकल्पों का इस्तेमाल करके, मैप की स्टाइल बदलने का तरीका बताया गया है. सेट किए जा सकने वाले मैप के विकल्पों के बारे में ज़्यादा जानने के लिए, Google Maps JavaScript API के रेफ़रंस में
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" }
]
}
]
}
});
SDK टूल को टास्क के डेटा की विज़िबिलिटी को कंट्रोल करना
विज़िबिलिटी के नियमों का इस्तेमाल करके, मैप पर कुछ टास्क ऑब्जेक्ट की विज़िबिलिटी को कंट्रोल किया जा सकता है.
टास्क के डेटा की डिफ़ॉल्ट विज़िबिलिटी
डिफ़ॉल्ट रूप से, किसी वाहन को असाइन किए गए टास्क का डेटा, तब दिखता है, जब वाहन, टास्क की जगह से पांच स्टॉप के दायरे में हो. टास्क पूरा होने या रद्द होने पर, विज़िबिलिटी खत्म हो जाती है.
इस टेबल में, हर तरह के टास्क के लिए डिफ़ॉल्ट विज़िबिलिटी दिखाई गई है. कई टास्क के लिए विज़िबिलिटी को पसंद के मुताबिक बनाया जा सकता है, लेकिन सभी के लिए नहीं. टास्क टाइप के बारे में ज़्यादा जानने के लिए, टास्क के टाइप को शेड्यूल किए गए टास्क गाइड में देखें.
| टास्क किस तरह का है | डिफ़ॉल्ट विज़िबिलिटी | क्या इसे पसंद के मुताबिक बनाया जा सकता है? | ब्यौरा |
|---|---|---|---|
| उपलब्ध न होने वाले टास्क | नहीं दिख रहा है | नहीं | इसका इस्तेमाल, ड्राइवर के ब्रेक और ईंधन भरने के लिए किया जाता है. अगर डिलीवरी वाले टास्क के रास्ते में, किसी दूसरे वाहन का स्टॉप भी शामिल है, तो वह स्टॉप नहीं दिखता ऐसा तब होता है, जब उसमें सिर्फ़ उपलब्ध न होने वाले टास्क शामिल हों. डिलीवरी वाले टास्क के लिए, पहुंचने का अनुमानित समय और टास्क पूरा होने का अनुमानित समय अब भी दिखता है. |
| वाहन के खुले टास्क | दिख रहा है | हां | टास्क पूरा होने या रद्द होने पर, विज़िबिलिटी खत्म हो जाती है. वाहन के खुले टास्क की विज़िबिलिटी को पसंद के मुताबिक बनाया जा सकता है. वाहन के खुले टास्क की विज़िबिलिटी को पसंद के मुताबिक बनाना देखें. |
| वाहन के बंद टास्क | नहीं दिख रहा है | नहीं | वाहन के बंद टास्क की विज़िबिलिटी को पसंद के मुताबिक नहीं बनाया जा सकता. |
वाहन के खुले टास्क की विज़िबिलिटी को पसंद के मुताबिक बनाना
TaskTrackingInfo इंटरफ़ेस, टास्क के डेटा के कई एलिमेंट उपलब्ध कराता है.
इन्हें Consumer SDK की मदद से दिखाया जा सकता है.
| टास्क के डेटा के ऐसे एलिमेंट जिन्हें पसंद के मुताबिक बनाया जा सकता है | |
|---|---|
|
रास्ते की पॉलीलाइन पहुंचने का अनुमानित समय टास्क पूरा होने का अनुमानित समय |
टास्क की जगह तक पहुंचने के लिए, ड्राइविंग की बाकी बची दूरी बाकी बचे स्टॉप की संख्या वाहन की जगह की जानकारी |
हर टास्क के लिए विज़िबिलिटी के विकल्प
Fleet Engine में कोई टास्क बनाते या अपडेट करते समय,
TaskTrackingViewConfig सेट करके, हर टास्क के हिसाब से विज़िबिलिटी के कॉन्फ़िगरेशन को पसंद के मुताबिक बनाया जा सकता है. टास्क के एलिमेंट की विज़िबिलिटी तय करने के लिए मानदंड बनाने के लिए, विज़िबिलिटी के इन विकल्पों का इस्तेमाल करें:
| विज़िबिलिटी के विकल्प | ||
|---|---|---|
|
बाकी बचे स्टॉप की संख्या पहुंचने के अनुमानित समय तक की अवधि ड्राइविंग की बाकी बची दूरी |
हमेशा दिखेगा कभी नहीं दिखेगा |
|
उदाहरण के लिए, मान लें कि पसंद के मुताबिक बनाने के किसी उदाहरण में, यहां दी गई टेबल में दिखाए गए मानदंडों का इस्तेमाल करके, डेटा के तीन एलिमेंट की विज़िबिलिटी को अडजस्ट किया जाता है. अन्य सभी एलिमेंट, विज़िबिलिटी के डिफ़ॉल्ट नियमों के मुताबिक दिखते हैं.
| अडजस्ट करने के लिए डेटा एलिमेंट | विज़िबिलिटी | मानदंड |
|---|---|---|
| रास्ते की पॉलीलाइन | दिखाएं | वाहन, तीन स्टॉप के दायरे में है. |
| ETA | दिखाएं | ड्राइविंग की बाकी बची दूरी, 5,000 मीटर से कम है. |
| बाकी बचे स्टॉप की संख्या | कभी न दिखाएं | वाहन, तीन स्टॉप के दायरे में है. |
यहां दिए गए उदाहरण में, यह कॉन्फ़िगरेशन दिखाया गया है:
"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
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});