JavaScript SDK टूल की मदद से, Fleet Engine में ट्रैक किए गए वाहनों की
जगह और दिलचस्पी की जगहों की जानकारी को विज़ुअलाइज़ किया जा सकता है. लाइब्रेरी में
JavaScript का एक मैप कॉम्पोनेंट होता है. यह स्टैंडर्ड google.maps.Map
इकाई और Fleet Engine से कनेक्ट करने के लिए, डेटा कॉम्पोनेंट को
ड्रॉप-इन करता है. JavaScript SDK का इस्तेमाल करके,
अपने वेब ऐप्लिकेशन से पसंद के मुताबिक बनाया जा सकने वाला ऐनिमेटेड ट्रिप और ऑर्डर की प्रोग्रेस का अनुभव दिया जा सकता है.
घटक
JavaScript SDK, वाहनों और वेपॉइंट के विज़ुअलाइज़ेशन के लिए कॉम्पोनेंट उपलब्ध कराता है. साथ ही, ड्राइवर के ईटीए या ड्राइव के लिए बची हुई दूरी के लिए, रॉ डेटा फ़ीड उपलब्ध कराता है.
यात्रा और ऑर्डर की स्थिति का मैप व्यू
मैप व्यू कॉम्पोनेंट, वाहनों और वेपॉइंट की जगह की जानकारी दिखाता है. अगर किसी वाहन का रास्ता जाना जा चुका है, तो मैप व्यू कॉम्पोनेंट उस वाहन को अपने अनुमानित रास्ते पर चलते हुए ऐनिमेट करता है.
यात्रा की जगह की जानकारी देने वाली कंपनी
JavaScript SDK में एक ट्रिप लोकेशन प्रोवाइडर शामिल होता है. यह ट्रिप और ऑर्डर की प्रोग्रेस मैप में ट्रैक किए गए ऑब्जेक्ट की जगह की जानकारी फ़ीड करता है.
यात्रा की जगह की जानकारी देने वाली सुविधा का इस्तेमाल करके, इन्हें ट्रैक किया जा सकता है:
- किसी यात्रा के पिकअप या ड्रॉप की जगह.
- जिस वाहन को यात्रा के लिए असाइन किया गया है उसकी जगह और रास्ता.
ट्रैक किए गए स्थान ऑब्जेक्ट
जगह की जानकारी देने वाली कंपनी, वेपॉइंट और वाहनों जैसे ऑब्जेक्ट की जगह को ट्रैक करती है.
यात्रा शुरू करने की जगह
मूल जगह वह जगह है जहां से यात्रा शुरू होती है. यह पिकअप की जगह को मार्क करता है.
गंतव्य स्थान
मंज़िल की जगह वह जगह होती है जहां कोई यात्रा खत्म होती है. यह ड्रॉप की जगह को मार्क करता है.
वेपॉइंट की जगह
ट्रैक की गई यात्रा के रास्ते में आने वाले किसी स्थान को वेपॉइंट स्थान कहते हैं. उदाहरण के लिए, किसी बस के रास्ते का हर स्टॉप, वेपॉइंट की जगह है.
वाहन की जगह की जानकारी
वाहन की जगह की जानकारी, किसी वाहन को ट्रैक की गई जगह की जानकारी होती है. इसमें वाहन के लिए रूट शामिल किया जा सकता है.
पुष्टि करने वाला टोकन फ़ेचर
Fleet Engine में सेव की गई जगह की जानकारी के डेटा के ऐक्सेस को कंट्रोल करने के लिए, आपको अपने सर्वर पर Fleet Engine के लिए, JSON वेब टोकन (JWT) मिंटिंग सेवा लागू करनी होगी. इसके बाद, जगह की जानकारी के ऐक्सेस की पुष्टि करने के लिए, JavaScript SDK का इस्तेमाल करके अपने वेब ऐप्लिकेशन के हिस्से के तौर पर, पुष्टि करने वाले टोकन फ़ेचर को लागू करें.
स्टाइल के विकल्प
मार्कर और पॉलीलाइन स्टाइल, मैप पर जगह की ट्रैक किए गए ऑब्जेक्ट का लुक और स्टाइल तय करते हैं. पसंद के मुताबिक स्टाइल के विकल्पों का इस्तेमाल करके, डिफ़ॉल्ट स्टाइल को अपने वेब ऐप्लिकेशन की स्टाइल से मैच किया जा सकता है.
ट्रैक की गई जगहों के दिखने की सेटिंग को कंट्रोल करना
इस सेक्शन में बताया गया है कि फ़्लीट इंजन की, जगह की जानकारी देने वाली पहले से तय की गई कंपनियों के लिए, मैप पर ट्रैक की गई जगह से जुड़े ऑब्जेक्ट को दिखाने के क्या नियम हैं. कस्टम या डिराइव्ड जगह की जानकारी देने वाली कंपनियां, 'किसको दिखे' सेटिंग में बदलाव कर सकती हैं.
वाहन
राइड शेयर करने वाला वाहन, यात्रा को असाइन किए जाने से लेकर ड्रॉप ऑफ़ के समय तक दिखता है. अगर यात्रा रद्द हो जाती है, तो वाहन लंबे समय तक दिखेगा.
अन्य सभी स्थान मार्कर
शुरुआत की जगह, मंज़िल, और वेपॉइंट के लिए दूसरे सभी लोकेशन मार्कर, मैप पर हमेशा दिखाए जाते हैं. उदाहरण के लिए, राइडशेयर करने की जगह या शिपमेंट डिलीवर करने की जगह को मैप पर हमेशा दिखाया जाता है, भले ही यात्रा या डिलीवरी की स्थिति कुछ भी हो.
JavaScript SDK टूल का इस्तेमाल शुरू करना
JavaScript SDK टूल का इस्तेमाल करने से पहले, पक्का करें कि आपको Fleet Engine और एपीआई पासकोड पाने के बारे में जानकारी हो.
राइडशेयरिंग की यात्रा को ट्रैक करने के लिए, पहले यात्रा आईडी का दावा करें.
ट्रिप आईडी का दावा करना
यात्रा की जगह की जानकारी देने वाली कंपनी का इस्तेमाल करके, यात्रा को ट्रैक करने के लिए, यात्रा आईडी के दावे के साथ JSON वेब टोकन (JWT) बनाएं.
JWT पेलोड बनाने के लिए, अनुमति देने वाले सेक्शन में tripid की मदद से एक और दावा जोड़ें और इसकी वैल्यू को ट्रिप आईडी पर सेट करें.
यहां दिए गए उदाहरण में, यात्रा के आईडी से ट्रैक करने के लिए टोकन बनाने का तरीका बताया गया है:
{
"alg": "RS256",
"typ": "JWT",
"kid": "private_key_id_of_consumer_service_account"
}
.
{
"iss": "consumer@yourgcpproject.iam.gserviceaccount.com",
"sub": "consumer@yourgcpproject.iam.gserviceaccount.com",
"aud": "https://fleetengine.googleapis.com/",
"iat": 1511900000,
"exp": 1511903600,
"scope": "https://www.googleapis.com/auth/xapi",
"authorization": {
"tripid": "tid_12345",
}
}
पुष्टि करने वाला टोकन फ़ेचर बनाएं
आपके पास पुष्टि करने वाला टोकन फ़ेचर बनाने का विकल्प होता है. इससे, अपने सर्वर पर सही दावों वाला टोकन हासिल किया जा सकता है. इसके लिए, आपको अपने प्रोजेक्ट के सेवा खाते के सर्टिफ़िकेट का इस्तेमाल करना होगा. यह ज़रूरी है कि आप सिर्फ़ अपने सर्वर पर टोकन मिंट करें और आपके सर्टिफ़िकेट किसी भी क्लाइंट के साथ शेयर न करें. ऐसा न करने पर, आपके सिस्टम की सुरक्षा को खतरा हो सकता है.
फ़ेचर को प्रॉमिस में रैप किए गए दो फ़ील्ड के साथ डेटा स्ट्रक्चर दिखाना होगा:
- स्ट्रिंग
token
. - नंबर
expiresInSeconds
. फ़ेच करने के बाद इतने समय में टोकन खत्म हो जाता है.
इनमें से किसी भी बात के सही होने पर, JavaScript Consumer SDK टूल, ऑथेंटिकेशन टोकन फ़ेचर की मदद से टोकन का अनुरोध करता है:
- इसमें मान्य टोकन नहीं होता है, जैसे कि जब इसने हाल ही के पेज लोड पर फ़ेचर को कॉल नहीं किया है या जब फ़ेचर कोई टोकन नहीं देता है.
- इसे पहले फ़ेच किए गए टोकन की समयसीमा खत्म हो गई है.
- इससे पहले जो टोकन फ़ेच किया गया था उसकी समयसीमा खत्म होने के एक मिनट के अंदर का समय है.
ऐसा न होने पर, SDK टूल पहले जारी किए गए मान्य टोकन का इस्तेमाल करता है और फ़ेचर को कॉल नहीं करता.
इस उदाहरण में, पुष्टि करने वाला टोकन फ़ेचर बनाने का तरीका बताया गया है:
JavaScript
async 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
};
}
TypeScript
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.jwt,
expiresInSeconds: data.expirationTimestamp - Date.now(),
};
}
टोकन इकट्ठा करने के लिए सर्वर-साइड एंडपॉइंट लागू करते समय, इन बातों को ध्यान में रखें:
- यह ज़रूरी है कि एंडपॉइंट से, टोकन की समयसीमा खत्म होने का समय दिखाया जाए. ऊपर दिए गए उदाहरण में, यह
data.ExpiresInSeconds
के तौर पर दिखाया गया है. - पुष्टि करने वाले टोकन फ़ेचर को लाइब्रेरी में, डेटा फ़ेच करने की समयसीमा खत्म होने का समय (सेकंड में) पास करना होगा, जैसा कि उदाहरण में दिखाया गया है.
- SERVER_TOKEN_URL, प्रोवाइडर को लागू करने पर निर्भर करता है. ये उदाहरण देने वाली कंपनी के यूआरएल हैं:
- https://
SERVER_URL
/token/driver/VEHICLEID
- https://
SERVER_URL
/token/consumer/TRIPID
- https://
एचटीएमएल से कोई मैप लोड करें
नीचे दिए गए उदाहरण में, किसी यूआरएल से JavaScript SDK
को लोड करने का तरीका बताया गया है. एपीआई लोड होने के बाद, callback पैरामीटर initMap
फ़ंक्शन एक्ज़ीक्यूट करता है. defer एट्रिब्यूट का इस्तेमाल करके, ब्राउज़र एपीआई के लोड होने के दौरान आपके बाकी पेज को रेंडर करना जारी रखता है.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
किसी यात्रा के बाद
इस सेक्शन में बताया गया है कि राइडशेयरिंग या डिलीवरी ट्रिप को फ़ॉलो करने के लिए, JavaScript SDK टूल का इस्तेमाल कैसे किया जाए. अपना कोड चलाने से पहले, स्क्रिप्ट टैग में दिए गए कॉलबैक फ़ंक्शन से लाइब्रेरी लोड कर लें.
यात्रा की जगह की जानकारी देने वाली कंपनी को इंस्टैंशिएट करें
JavaScript SDK टूल, Fleet Engine राइडशेयरिंग एपीआई के लिए, जगह की जानकारी देने वाली कंपनी की जानकारी देता है. इसे इंस्टैंशिएट करने के लिए, अपने प्रोजेक्ट आईडी और टोकन फ़ैक्ट्री के रेफ़रंस का इस्तेमाल करें.
JavaScript
locationProvider =
new google.maps.journeySharing
.FleetEngineTripLocationProvider({
projectId: 'your-project-id',
authTokenFetcher: authTokenFetcher, // the token fetcher defined in the previous step
// Optionally, you may specify a trip ID to
// immediately start tracking.
tripId: 'your-trip-id',
});
TypeScript
locationProvider =
new google.maps.journeySharing
.FleetEngineTripLocationProvider({
projectId,
authTokenFetcher,
// Optionally, you may specify a trip ID to
// immediately start tracking.
tripId: 'your-trip-id',
});
मैप व्यू शुरू करना
JavaScript SDK लोड होने के बाद, मैप व्यू शुरू करें और उसे एचटीएमएल पेज में जोड़ें. आपके पेज में <div> एलिमेंट होना चाहिए, जिसमें मैप व्यू हो. नीचे दिए गए उदाहरण में, <div> एलिमेंट को map_canvas नाम दिया गया है.
रेस की शर्तों से बचने के लिए, मैप शुरू होने के बाद शुरू किए गए कॉलबैक में, जगह की जानकारी देने वाले के लिए यात्रा आईडी सेट करें.
JavaScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerCustomization: vehicleMarkerCustomization,
activePolylineCustomization: activePolylineCustomization,
// Any undefined styling options will use defaults.
});
// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.tripId = 'your-trip-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({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerCustomization: vehicleMarkerCustomization,
activePolylineCustomization: activePolylineCustomization,
// Any undefined styling options will use defaults.
});
// If you did not specify a trip ID in the location
// provider constructor, you may do so here.
locationProvider.tripId = 'your-trip-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({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);
बदलाव के इवेंट सुनना
जगह की जानकारी देने वाली सुविधा का इस्तेमाल करके, टास्क ऑब्जेक्ट से यात्रा की मेटा जानकारी पाएं. मेटा जानकारी में ETA और पिकअप या ड्रॉप-ऑफ़ से पहले की दूरी शामिल होती है. मेटा जानकारी में होने वाले बदलावों से, अपडेट इवेंट ट्रिगर होता है. नीचे दिए गए उदाहरण में, बदलाव से जुड़े इन इवेंट को सुनने का तरीका बताया गया है.
JavaScript
locationProvider.addListener('update', e => {
// e.trip contains data that may be useful
// to the rest of the UI.
console.log(e.trip.dropOffTime);
});
TypeScript
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent) => {
// e.trip contains data that may be useful
// to the rest of the UI.
console.log(e.trip.dropOffTime);
});
गड़बड़ियां ठीक करना
यात्रा की जानकारी का अनुरोध करने से एसिंक्रोनस रूप से पैदा होने वाली गड़बड़ियां, गड़बड़ी वाले इवेंट को ट्रिगर करती हैं. नीचे दिए गए उदाहरण में, गड़बड़ियों को ठीक करने के लिए इन इवेंट को सुनने का तरीका बताया गया है.
JavaScript
locationProvider.addListener('error', e => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});
TypeScript
locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});
ध्यान दें: अगर आपको इस बात की जानकारी नहीं है कि गड़बड़ियों को ठीक करना है, तो try...catch
ब्लॉक में लाइब्रेरी कॉल को रैप करना न भूलें.
ट्रैकिंग रोकें
जगह की जानकारी देने वाली कंपनी को यात्रा ट्रैक करने से रोकने के लिए, जगह की जानकारी देने वाली कंपनी से यात्रा आईडी हटाएं.
JavaScript
locationProvider.tripId = '';
TypeScript
locationProvider.tripId = '';
मैप व्यू से, जगह की जानकारी देने वाली कंपनी को हटाएं
नीचे दिए गए उदाहरण में, मैप व्यू से जगह की जानकारी देने वाली कंपनी को हटाने का तरीका बताया गया है.
JavaScript
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
बुनियादी मैप के रंग-रूप को पसंद के मुताबिक बनाना
मैप कॉम्पोनेंट के लुक को पसंद के मुताबिक बनाने के लिए, क्लाउड-आधारित टूल का इस्तेमाल करके या सीधे कोड में विकल्प सेट करके, अपने मैप की स्टाइल बदलें.
क्लाउड-आधारित मैप स्टाइल का इस्तेमाल करना
क्लाउड-आधारित मैप की स्टाइल से, आपको Google Cloud कंसोल से Google Maps का इस्तेमाल करने वाले अपने सभी ऐप्लिकेशन के लिए, मैप स्टाइल बनाने और उनमें बदलाव करने की सुविधा मिलती है. इसके लिए, आपको कोड में कोई बदलाव करने की ज़रूरत नहीं होती.
मैप की स्टाइल, आपके Cloud प्रोजेक्ट में मैप आईडी के तौर पर सेव की जाती हैं. अपने JavaScript SDK टूल के मैप पर कोई स्टाइल लागू करने के लिए, JourneySharingMapView
बनाते समय mapId
और किसी दूसरे mapOptions
के बारे में बताएं. JourneySharingMapView
को इंस्टैंशिएट करने के बाद, mapId
फ़ील्ड को बदला या जोड़ा नहीं जा सकता. नीचे दिए गए उदाहरण में, पहले बनाए गए मैप स्टाइल को मैप आईडी के साथ चालू करने का तरीका बताया गया है.
JavaScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// and any other styling options.
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// and any other styling options.
});
कोड पर आधारित मैप स्टाइलिंग का इस्तेमाल करना
मैप की स्टाइल को पसंद के मुताबिक बनाने का एक और तरीका है, JourneySharingMapView
बनाते समय 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" }
]
}
]
}
});
मार्कर कस्टमाइज़ेशन का इस्तेमाल करना
JavaScript SDK टूल की मदद से, मैप में जोड़े गए मार्कर के लुक और स्टाइल को पसंद के मुताबिक बनाया जा सकता है. आप मार्कर कस्टमाइज़ेशन तय करके ऐसा करते हैं, जिसे मैप पर मार्कर जोड़ने और हर मार्कर अपडेट के साथ, JavaScript SDK टूल लागू करता है.
सबसे आसान पसंद के मुताबिक बनाने के लिए, ऐसा
MarkerOptions
ऑब्जेक्ट तय करना है जिसे एक ही तरह के सभी मार्कर पर लागू किया जाएगा. ऑब्जेक्ट में बताए गए बदलाव, हर मार्कर बनाने के बाद लागू होते हैं. साथ ही, ये बदलाव किसी भी डिफ़ॉल्ट विकल्प को ओवरराइट कर देते हैं.
कस्टम फ़ंक्शन के बारे में बताना ज़्यादा बेहतर विकल्प है. कस्टमाइज़ेशन फ़ंक्शन की मदद से, डेटा के आधार पर मार्कर की स्टाइल बनाई जा सकती है. साथ ही, क्लिक हैंडलिंग जैसे मार्कर में इंटरैक्टिविटी जोड़ी जा सकती है. खास तौर पर, यात्रा और ऑर्डर प्रोग्रेस मार्कर की ओर से दिखाए जाने वाले ऑब्जेक्ट के टाइप के बारे में कस्टमाइज़ेशन फ़ंक्शन को डेटा भेजता है: वाहन, शुरुआत की जगह, वेपॉइंट या मंज़िल. इससे मार्कर की मौजूदा स्थिति के हिसाब से, मार्कर की स्टाइल बदलने की सुविधा मिलती है. उदाहरण के लिए, वाहन के ट्रिप खत्म होने तक बाकी वेपॉइंट की संख्या. यहां तक कि आप Fleet Engine के बाहर के स्रोतों के डेटा से भी जुड़ सकते हैं और उस जानकारी के आधार पर मार्कर को शैली दे सकते हैं.
JavaScript SDK टूल, FleetEngineTripLocationProviderOptions
में ये कस्टमाइज़ेशन पैरामीटर उपलब्ध कराता है:
vehicleMarkerCustomization
originMarkerCustomization
waypointMarkerCustomization
destinationMarkerCustomization
MarkerOptions
का उपयोग करके मार्कर की शैली बदलें
यहां दिए गए उदाहरण में, MarkerOptions
ऑब्जेक्ट के साथ वाहन के मार्कर की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. पहले से सूची में दिए गए किसी भी मार्कर कस्टमाइज़ेशन का इस्तेमाल करके, किसी भी मार्कर की स्टाइल को पसंद के मुताबिक बनाने के लिए इस पैटर्न का पालन करें.
JavaScript
vehicleMarkerCustomization = {
cursor: 'grab'
};
TypeScript
vehicleMarkerCustomization = {
cursor: 'grab'
};
कस्टमाइज़ेशन फ़ंक्शन का इस्तेमाल करके मार्कर की स्टाइल बदलें
नीचे दिए गए उदाहरण में, वाहन के मार्कर की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. पहले से सूची में दिए गए किसी भी मार्कर कस्टमाइज़ेशन पैरामीटर का इस्तेमाल करके, किसी भी मार्कर की स्टाइल को पसंद के मुताबिक बनाने के लिए, इस पैटर्न का पालन करें.
JavaScript
vehicleMarkerCustomization =
(params) => {
var distance = params.trip.remainingWaypoints.length;
params.marker.setLabel(`${distance}`);
};
TypeScript
vehicleMarkerCustomization =
(params: TripMarkerCustomizationFunctionParams) => {
const distance = params.trip.remainingWaypoints.length;
params.marker.setLabel(`${distance}`);
};
मार्कर में क्लिक हैंडलिंग जोड़ें
नीचे दिए गए उदाहरण में, वाहन के मार्कर में क्लिक हैंडलिंग जोड़ने का तरीका बताया गया है. पहले से सूची में दिए गए किसी भी मार्कर कस्टमाइज़ेशन पैरामीटर का इस्तेमाल करके, किसी भी मार्कर में क्लिक हैंडलिंग जोड़ने के लिए इस पैटर्न का पालन करें.
JavaScript
vehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
TypeScript
vehicleMarkerCustomization =
(params: TripMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
पॉलीलाइन कस्टमाइज़ेशन का इस्तेमाल करना
JavaScript SDK टूल की मदद से, मैप पर यात्रा के रास्ते के लुक और स्टाइल को पसंद के मुताबिक बनाया जा सकता है. लाइब्रेरी, वाहन के चालू या बचे हुए पाथ में कोऑर्डिनेट के हर जोड़े के लिए, एक google.maps.Polyline
ऑब्जेक्ट बनाती है.
पॉलीलाइन कस्टमाइज़ेशन के बारे में बताकर, Polyline
ऑब्जेक्ट को स्टाइल किया जा सकता है. इसके बाद, लाइब्रेरी इन कस्टमाइज़ेशन को दो स्थितियों में लागू करती है: मैप पर ऑब्जेक्ट जोड़ने से पहले, और ऑब्जेक्ट के लिए इस्तेमाल किए गए डेटा में बदलाव होने से पहले.
मार्कर को पसंद के मुताबिक बनाने की तरह ही, PolylineOptions
का एक सेट तय किया जा सकता है, जो मेल खाने वाले सभी Polyline
ऑब्जेक्ट पर लागू हो जाए. ऐसा तब होता है, जब उन्हें बनाया या अपडेट किया जाता है.
इसी तरह, कस्टमाइज़ेशन फ़ंक्शन तय किया जा सकता है. कस्टमाइज़ेशन फ़ंक्शन, Fleet Engine से मिले डेटा के आधार पर, ऑब्जेक्ट को अलग-अलग स्टाइल में बदलने की सुविधा देते हैं.
यह फ़ंक्शन, वाहन की मौजूदा स्थिति के हिसाब से हर ऑब्जेक्ट की स्टाइल बदल सकता है. उदाहरण के लिए, वाहन के धीरे चलने पर, Polyline
ऑब्जेक्ट को ज़्यादा गहरा रंग या मोटा करके दिखाना. आप चाहें, तो Fleet Engine के बाहर के सोर्स से भी मीटिंग में शामिल हुआ जा सकता है और उस जानकारी के आधार पर Polyline
ऑब्जेक्ट को स्टाइल किया जा सकता है.
FleetEngineTripLocationProviderOptions
में दिए गए पैरामीटर का इस्तेमाल करके, कस्टमाइज़ेशन के बारे में बताया जा सकता है.
आप वाहन की यात्रा के दौरान, पाथ की अलग-अलग स्थितियों के हिसाब से मनमुताबिक बदलाव करने की सुविधा सेट कर सकते हैं--वे पहले ही यात्रा कर चुके हैं, सक्रिय रूप से यात्रा कर चुके हैं या अभी तक यात्रा नहीं कर चुके हैं. पैरामीटर नीचे दिए गए हैं:
takenPolylineCustomization
, पहले से यात्रा कर चुके पाथ के लिए;activePolylineCustomization
, खास तौर पर यात्रा से जुड़े पाथ के लिए;remainingPolylineCustomization
, उस रास्ते के लिए जिस पर अभी तक यात्रा नहीं की गई है.
PolylineOptions
का इस्तेमाल करके, Polyline
ऑब्जेक्ट की स्टाइल बदलें
यहां दिए गए उदाहरण में, PolylineOptions
वाले Polyline
ऑब्जेक्ट की स्टाइलिंग को कॉन्फ़िगर करने का तरीका बताया गया है.
किसी भी Polyline
ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाने के लिए, इस पैटर्न को अपनाएं. इसके लिए, ऊपर बताए गए किसी भी पॉलीलाइन कस्टमाइज़ेशन का इस्तेमाल करें.
JavaScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
पसंद के मुताबिक बनाने के फ़ंक्शन का इस्तेमाल करके, Polyline
ऑब्जेक्ट की स्टाइल बदलें
इस उदाहरण में, चालू Polyline
ऑब्जेक्ट की स्टाइल को कॉन्फ़िगर करने का तरीका बताया गया है. इस पैटर्न को फ़ॉलो करके, किसी भी Polyline
ऑब्जेक्ट की स्टाइल को पसंद के मुताबिक बनाएं. इसके लिए, ऊपर दिए गए किसी भी पॉलीलाइन कस्टम पैरामीटर का इस्तेमाल करें.
JavaScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.trip.remainingWaypoints[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'});
});
}
};
TypeScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: TripPolylineCustomizationFunctionParams) => {
const distance = params.trip.remainingWaypoints[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
प्रॉपर्टी को सेट करें:
JavaScript
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};
ट्रैफ़िक की जानकारी देने वाले Polyline
ऑब्जेक्ट रेंडर करें
Fleet Engine, फ़ॉलो किए गए वाहन के लिए, चालू और बाकी पाथ के ट्रैफ़िक की स्पीड का डेटा दिखाता है. इस जानकारी का इस्तेमाल करके, Polyline
ऑब्जेक्ट को उनकी ट्रैफ़िक स्पीड के हिसाब से स्टाइल में बांटा जा सकता है:
JavaScript
// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
FleetEngineTripLocationProvider.
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) => {
FleetEngineTripLocationProvider.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
for (const polylineObject of params.polylines) {
if (polylineObject.get('strokeColor') === '#05f') {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
FleetEngineTripLocationProvider.
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: TripPolylineCustomizationFunctionParams) => {
FleetEngineTripLocationProvider.
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
बनाने और उसे वाहन के मार्कर से अटैच करने का तरीका बताया गया है:
JavaScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
locationProvider.addListener('update', e => {
const stopsCount = e.trip.remainingWaypoints.length;
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.FleetEngineTripLocationProviderUpdateEvent) => {
const stopsCount = e.trip.remainingWaypoints.length;
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();
अपने-आप फ़िट होने की सुविधा बंद करें
अपने-आप फ़िट होने की सुविधा को बंद करके, मैप को व्यूपोर्ट में अपने-आप फ़िट होने से रोका जा सकता है और अनुमानित रास्ते को रोका जा सकता है. नीचे दिए गए उदाहरण में बताया गया है कि ट्रिप और ऑर्डर की प्रोग्रेस के मैप व्यू को कॉन्फ़िगर करते समय, अपने-आप फ़िट होने की सुविधा को कैसे बंद किया जाए.
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,
...
});
कोई मौजूदा मैप बदलें
मार्कर या अन्य कस्टमाइज़ेशन वाले मौजूदा मैप को बदलने के लिए, JavaScript SDK टूल का इस्तेमाल किया जा सकता है.
उदाहरण के लिए, मान लें कि आपके पास मानक 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 Uluru
var uluru = {lat: -25.344, lng: 131.036};
// The map, centered at Uluru
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, positioned at Uluru
var marker = new google.maps.Marker({position: uluru, 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 SDK टूल जोड़ने के लिए:
- पुष्टि करने वाले टोकन की फ़ैक्ट्री के लिए कोड जोड़ें.
initMap()
फ़ंक्शन में जगह की जानकारी देने वाली कंपनी को शुरू करें.initMap()
फ़ंक्शन में मैप व्यू को शुरू करें. इस व्यू में मैप शामिल है.- मैप व्यू शुरू करने के लिए, अपनी पसंद के मुताबिक बनाने की सुविधा को कॉलबैक फ़ंक्शन में ले जाएं.
- एपीआई लोडर में, जगह की जानकारी वाली लाइब्रेरी जोड़ें.
नीचे दिए गए उदाहरण में, किए जाने वाले बदलाव दिखाए गए हैं:
<!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
async 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.
locationProvider = new google.maps.journeySharing.FleetEngineTripLocationProvider({
projectId: "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
});
locationProvider.tripId = TRIP_ID;
// (4) Add customizations like before.
// The location of Uluru
var uluru = {lat: -25.344, lng: 131.036};
// The map, centered at Uluru
var map = mapView.map;
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, positioned at Uluru
var marker = new google.maps.Marker({position: uluru, 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 SDK to the API loader.
-->
<script defer
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing">
</script>
</body>
</html>
अगर आप उलुरु के पास बताए गए आईडी वाली यात्रा की बुकिंग करते हैं, तो उसे अब मैप पर रेंडर किया जाएगा.