যখন আপনি কোনো ট্রিপ অনুসরণ করেন, তখন আপনার গ্রাহক অ্যাপটি গ্রাহককে উপযুক্ত যানবাহনটির অবস্থান প্রদর্শন করে। এটি করার জন্য, আপনার অ্যাপটিকে ট্রিপটি অনুসরণ করা শুরু করতে হবে, ট্রিপ চলাকালীন যাত্রার অগ্রগতি আপডেট করতে হবে এবং ট্রিপটি সম্পূর্ণ হলে তা অনুসরণ করা বন্ধ করতে হবে।
এই নথিতে এই প্রক্রিয়ার নিম্নলিখিত মূল ধাপগুলো অন্তর্ভুক্ত রয়েছে:
- একটি মানচিত্র তৈরি করুন
- একটি মানচিত্র শুরু করুন এবং শেয়ার করা যাত্রাটি প্রদর্শন করুন।
- ভ্রমণের অগ্রগতি আপডেট করুন এবং অনুসরণ করুন
- একটি ভ্রমণ অনুসরণ করা বন্ধ করুন
- ট্রিপ ত্রুটিগুলি পরিচালনা করুন
একটি মানচিত্র তৈরি করুন
আপনার ওয়েব অ্যাপে কোনো চালানের পিকআপ বা ডেলিভারি অনুসরণ করতে, আপনাকে একটি ম্যাপ লোড করতে হবে এবং আপনার যাত্রা ট্র্যাক করা শুরু করার জন্য কনজিউমার এসডিকে (Consumer SDK) ইনস্ট্যানশিয়েট করতে হবে। আপনি একটি নতুন ম্যাপ লোড করতে পারেন অথবা বিদ্যমান কোনো ম্যাপ ব্যবহার করতে পারেন। এরপর আপনি ইনিশিয়ালাইজেশন ফাংশনটি ব্যবহার করে কনজিউমার এসডিকে ইনস্ট্যানশিয়েট করবেন, যাতে ম্যাপ ভিউটি ট্র্যাক করা আইটেমটির অবস্থানের সাথে সামঞ্জস্যপূর্ণ হয়।
গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে একটি নতুন মানচিত্র লোড করুন
একটি নতুন ম্যাপ তৈরি করতে, আপনার ওয়েব অ্যাপে গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই লোড করুন। নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই লোড করতে হয়, এসডিকে সক্রিয় করতে হয় এবং ইনিশিয়ালাইজেশন চেকটি চালু করতে হয়।
-
callbackপ্যারামিটারটি এপিআই লোড হওয়ার পরেinitMapফাংশনটি চালায়। - `
deferঅ্যাট্রিবিউটটি এপিআই লোড হওয়ার সময়েও ব্রাউজারকে আপনার পেজের বাকি অংশ রেন্ডার করা চালিয়ে যেতে দেয়।
কনজিউমার এসডিকে ইনস্ট্যানশিয়েট করতে initMap ফাংশনটি ব্যবহার করুন। উদাহরণস্বরূপ:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
বিদ্যমান মানচিত্র লোড করুন
আপনি গুগল ম্যাপস জাভাস্ক্রিপ্ট এপিআই দ্বারা তৈরি একটি বিদ্যমান মানচিত্রও লোড করতে পারেন, যেমনটি আপনি ইতিমধ্যেই ব্যবহার করছেন।
উদাহরণস্বরূপ, ধরুন আপনার একটি ওয়েব পেজ আছে যেখানে একটি স্ট্যান্ডার্ড google.maps.Map এনটিটি রয়েছে এবং তাতে নিম্নলিখিত HTML কোডে সংজ্ঞায়িত একটি মার্কার দেখানো হয়েছে। এটি শেষের কলব্যাকে একই 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 এনটিটি-র উপর একটি মার্কার দেখানো হয়, তবে আপনি ম্যাপটি প্রতিস্থাপন করে মার্কারটি রাখতে পারেন। এই বিভাগে তা করার ধাপগুলো বর্ণনা করা হয়েছে।
ম্যাপ প্রতিস্থাপন করতে এবং কাস্টমাইজেশন বজায় রাখতে, এই ধাপগুলো অনুসরণ করে আপনার HTML পেজে জার্নি শেয়ারিং যোগ করুন, যা নিচের উদাহরণে সংখ্যা দিয়ে চিহ্নিত করা আছে:
অথেনটিকেশন টোকেন ফ্যাক্টরির জন্য কোড যোগ করুন।
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>
একটি মানচিত্র শুরু করুন এবং ভ্রমণের অগ্রগতি প্রদর্শন করুন।
যখন কোনো ট্রিপ শুরু হয়, তখন ট্রিপের অগ্রগতি শেয়ার করা শুরু করার জন্য আপনার অ্যাপকে একটি ট্রিপ লোকেশন প্রোভাইডার ইনস্ট্যানশিয়েট করতে হবে এবং তারপর একটি ম্যাপ ইনিশিয়ালাইজ করতে হবে। উদাহরণের জন্য নিম্নলিখিত বিভাগগুলি দেখুন।
একটি ট্রিপ লোকেশন প্রোভাইডার ইনস্ট্যানশিয়েট করুন
জাভাস্ক্রিপ্ট এসডিকে-তে ফ্লিট ইঞ্জিন রাইডশেয়ারিং এপিআই-এর জন্য একটি পূর্বনির্ধারিত লোকেশন প্রোভাইডার রয়েছে। এটি ইনস্ট্যানশিয়েট করতে আপনার প্রজেক্ট আইডি এবং আপনার টোকেন ফ্যাক্টরির একটি রেফারেন্স ব্যবহার করুন।
জাভাস্ক্রিপ্ট
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',
});
টাইপস্ক্রিপ্ট
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',
});
মানচিত্র দৃশ্য শুরু করুন
জাভাস্ক্রিপ্ট এসডিকে লোড করার পর, ম্যাপ ভিউটি ইনিশিয়ালাইজ করুন এবং এইচটিএমএল পেজে যোগ করুন। আপনার পেজে একটি <div> এলিমেন্ট থাকতে হবে, যার মধ্যে ম্যাপ ভিউটি থাকবে। নিচের উদাহরণে <div> এলিমেন্টটির নাম map_canvas দেওয়া হয়েছে।
জাভাস্ক্রিপ্ট
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);
টাইপস্ক্রিপ্ট
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);
ভ্রমণের অগ্রগতি আপডেট করুন এবং অনুসরণ করুন
আপনার অ্যাপের উচিত ইভেন্টগুলো শোনা এবং যাত্রা এগোনোর সাথে সাথে ট্রিপের অগ্রগতি আপডেট করা। আপনি লোকেশন প্রোভাইডার ব্যবহার করে টাস্ক অবজেক্ট থেকে একটি ট্রিপের মেটা তথ্য সংগ্রহ করতে পারেন। এই মেটা তথ্যের মধ্যে পিকআপ বা ড্রপঅফের আগে পৌঁছানোর আনুমানিক সময় (ETA) এবং অবশিষ্ট দূরত্ব অন্তর্ভুক্ত থাকে। মেটা তথ্যের পরিবর্তন একটি আপডেট ইভেন্ট ট্রিগার করে। নিম্নলিখিত উদাহরণটি দেখায় কিভাবে এই পরিবর্তন ইভেন্টগুলো শোনা যায়।
জাভাস্ক্রিপ্ট
locationProvider.addListener('update', e => {
// e.trip contains data that may be useful
// to the rest of the UI.
console.log(e.trip.dropOffTime);
});
টাইপস্ক্রিপ্ট
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);
});
একটি ভ্রমণ অনুসরণ করা বন্ধ করুন
ট্রিপ শেষ হলে, লোকেশন প্রোভাইডারকে ট্রিপটি ট্র্যাক করা থেকে বিরত রাখতে হবে। এটি করার জন্য, ট্রিপ আইডি এবং লোকেশন প্রোভাইডারটি মুছে ফেলুন। উদাহরণের জন্য পরবর্তী বিভাগগুলো দেখুন।
অবস্থান প্রদানকারী থেকে ট্রিপ আইডিটি সরিয়ে ফেলুন
নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে লোকেশন প্রোভাইডার থেকে একটি ট্রিপ আইডি মুছে ফেলতে হয়।
জাভাস্ক্রিপ্ট
locationProvider.tripId = '';
টাইপস্ক্রিপ্ট
locationProvider.tripId = '';
মানচিত্র দৃশ্য থেকে অবস্থান প্রদানকারীকে সরান
নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে ম্যাপ ভিউ থেকে একটি লোকেশন প্রোভাইডার সরানো যায়।
জাভাস্ক্রিপ্ট
mapView.removeLocationProvider(locationProvider);
টাইপস্ক্রিপ্ট
mapView.removeLocationProvider(locationProvider);
ট্রিপ ত্রুটিগুলি পরিচালনা করুন
ট্রিপের তথ্য অনুরোধ করার ফলে অ্যাসিঙ্ক্রোনাসভাবে যে ত্রুটিগুলো ঘটে, সেগুলো এরর ইভেন্ট ট্রিগার করে। নিম্নলিখিত উদাহরণটি দেখায় কীভাবে ত্রুটিগুলি পরিচালনা করার জন্য এই ইভেন্টগুলি লিসেন করতে হয়।
জাভাস্ক্রিপ্ট
locationProvider.addListener('error', e => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});
টাইপস্ক্রিপ্ট
locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
// e.error contains the error that triggered the
// event
console.error(e.error);
});