किसी यात्रा को फ़ॉलो करने पर, आपका उपभोक्ता ऐप्लिकेशन उपभोक्ता को सही वाहन की जगह दिखाता है. ऐसा करने के लिए, आपके ऐप्लिकेशन को यात्रा को ट्रैक करना शुरू करना होगा, यात्रा के दौरान उसकी प्रोग्रेस अपडेट करनी होगी, और यात्रा पूरी होने पर उसे ट्रैक करना बंद करना होगा.
इस दस्तावेज़ में, इस प्रोसेस के इन अहम चरणों के बारे में बताया गया है:
- मैप सेट अप करना
- मैप को शुरू करना और शेयर की गई यात्रा की जानकारी दिखाना
- यात्रा की स्थिति अपडेट करना और उसे फ़ॉलो करना
- किसी यात्रा को फ़ॉलो करना बंद करना
- यात्रा से जुड़ी गड़बड़ियां ठीक करना
मैप सेट अप करना
अपने वेब ऐप्लिकेशन में शिपमेंट के पिकअप या डिलीवरी की जानकारी देखने के लिए, आपको एक मैप लोड करना होगा. साथ ही, अपनी यात्रा को ट्रैक करने के लिए, Consumer SDK टूल को इंस्टैंशिएट करना होगा. आपके पास नया मैप लोड करने या किसी मौजूदा मैप का इस्तेमाल करने का विकल्प होता है. इसके बाद, Consumer SDK टूल को शुरू करने के लिए, शुरू करने के फ़ंक्शन का इस्तेमाल किया जाता है, ताकि मैप व्यू, ट्रैक किए जा रहे आइटम की जगह से मेल खा सके.
Google Maps JavaScript API का इस्तेमाल करके नया मैप लोड करना
नया मैप बनाने के लिए, अपने वेब ऐप्लिकेशन में Google Maps JavaScript API लोड करें. यहां दिए गए उदाहरण में, Google Maps JavaScript API को लोड करने, SDK टूल को चालू करने, और शुरू करने से जुड़ी जांच को ट्रिगर करने का तरीका बताया गया है.
- एपीआई लोड होने के बाद,
callbackपैरामीटरinitMapफ़ंक्शन को चलाता है. deferएट्रिब्यूट की मदद से, ब्राउज़र आपके पेज के बाकी हिस्से को रेंडर करना जारी रखता है, जबकि एपीआई लोड होता है.
Consumer SDK को इंस्टैंशिएट करने के लिए, initMap फ़ंक्शन का इस्तेमाल करें. उदाहरण के लिए:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
कोई मौजूदा मैप लोड करना
Google Maps JavaScript API से बनाए गए किसी मौजूदा मैप को भी लोड किया जा सकता है. जैसे, वह मैप जिसका इस्तेमाल पहले से किया जा रहा है.
उदाहरण के लिए, मान लें कि आपके पास एक वेब पेज है, जिसमें स्टैंडर्ड google.maps.Map
इकाई है. इस पर मार्कर दिखाया गया है, जैसा कि नीचे दिए गए एचटीएमएल कोड में बताया गया है. यह आखिर में कॉलबैक में उसी 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>
// Initialize and add the map
function initMap() {
// The location of Pier 39 in San Francisco
var pier39 = {lat: 37.809326, lng: -122.409981};
// The map, initially centered at Mountain View, CA.
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Pier 39
var marker = new google.maps.Marker({position: pier39, map: map});
}
</script>
<!-- Load the API from the specified URL.
* The defer attribute allows the browser to render the page while the API loads.
* The key parameter contains your own API key.
* 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>
किसी मौजूदा मैप को बदलना
आपके पास किसी मौजूदा मैप को बदलने का विकल्प होता है. इसमें मार्कर या पसंद के मुताबिक किए गए अन्य बदलावों को बनाए रखा जा सकता है.
उदाहरण के लिए, अगर आपके पास कोई वेब पेज है, जिस पर स्टैंडर्ड google.maps.Map
इकाई के साथ मार्कर दिखाया गया है, तो मैप को बदला जा सकता है और मार्कर को रखा जा सकता है. इस सेक्शन में, ऐसा करने का तरीका बताया गया है.
मैप को बदलने और पसंद के मुताबिक बनाए गए बदलावों को बनाए रखने के लिए, अपने एचटीएमएल पेज में सफ़र की जानकारी शेयर करने की सुविधा जोड़ें. इसके लिए, यह तरीका अपनाएं. इस तरीके को नीचे दिए गए उदाहरण में नंबर के साथ भी बताया गया है:
पुष्टि करने वाले टोकन फ़ैक्ट्री के लिए कोड जोड़ें.
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 Pier 39 in San Francisco
var pier39 = {lat: 37.809326, lng: -122.409981};
// The map, initially centered at Mountain View, CA.
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Pier 39
var marker = new google.maps.Marker({position: pier39, 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>
मैप को शुरू करना और यात्रा की प्रोग्रेस दिखाना
यात्रा शुरू होने पर, आपके ऐप्लिकेशन को यात्रा की जगह की जानकारी देने वाली सेवा को इंस्टैंशिएट करना होगा. इसके बाद, यात्रा की प्रोग्रेस शेयर करने के लिए, मैप को शुरू करना होगा. उदाहरण के लिए, नीचे दिए गए सेक्शन देखें.
यात्रा की जगह की जानकारी देने वाली कंपनी को इंस्टैंशिएट करना
JavaScript SDK टूल में, Fleet Engine Ridesharing API के लिए पहले से तय की गई लोकेशन प्रोवाइडर की जानकारी होती है. इसे इंस्टैंशिएट करने के लिए, अपने प्रोजेक्ट आईडी और टोकन फ़ैक्ट्री के रेफ़रंस का इस्तेमाल करें.
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: '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',
});
मैप व्यू को शुरू करना
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.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// 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 starts 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 choose.
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.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// 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 starts 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 choose.
mapView.map.setCenter({lat: 37.2, lng: -121.9});
mapView.map.setZoom(14);
यात्रा की स्थिति अपडेट करना और उसे फ़ॉलो करना
आपका ऐप्लिकेशन, इवेंट को सुनना चाहिए और यात्रा के दौरान, यात्रा की प्रोग्रेस को अपडेट करना चाहिए. जगह की जानकारी देने वाली सेवा का इस्तेमाल करके, टास्क ऑब्जेक्ट से किसी यात्रा के बारे में मेटा जानकारी हासिल की जा सकती है. मेटा जानकारी में, ईटीए और पिकअप या ड्रॉपऑफ़ से पहले की बची हुई दूरी शामिल होती है. मेटा जानकारी में बदलाव करने पर, अपडेट इवेंट ट्रिगर होता है. नीचे दिए गए उदाहरण में, इन बदलाव इवेंट को सुनने का तरीका बताया गया है.
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.tripId = '';
TypeScript
locationProvider.tripId = '';
मैप व्यू से जगह की जानकारी देने वाली कंपनी का नाम हटाना
इस उदाहरण में, मैप व्यू से जगह की जानकारी देने वाली सेवा को हटाने का तरीका बताया गया है.
JavaScript
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
यात्रा से जुड़ी गड़बड़ियां ठीक करना
यात्रा की जानकारी का अनुरोध करने पर, गड़बड़ियां होने पर गड़बड़ी वाले इवेंट ट्रिगर होते हैं. नीचे दिए गए उदाहरण में, गड़बड़ियों को मैनेज करने के लिए इन इवेंट को सुनने का तरीका बताया गया है.
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);
});