এক নজরে
Google Maps Platform ওয়েব (JS, TS), Android ও iOS-এর জন্য উপলভ্য এবং জায়গা, দিকনির্দেশ ও দূরত্বের ব্যাপারে তথ্য পাওয়ার জন্য ওয়েব পরিষেবা API-ও অফার করে। এই গাইডের স্যাম্পেলগুলি একটি প্ল্যাটফর্মের জন্য লেখা হয়েছে, তবে অন্যান্য প্ল্যাটফর্মে প্রয়োগের জন্য ডকুমেন্টেশন লিঙ্ক প্রদান করা হয়েছে।
আপনার ব্যবহারকারীরা যখন আপনার প্রোডাক্ট অনলাইনে দেখেন, তখন তারা তাদের অর্ডার পাওয়ার সবচেয়ে ভালো এবং সবচেয়ে সুবিধাজনক উপায় খুঁজে পেতে চান। প্রোডাক্ট লোকেটর প্রয়োগ করার নির্দেশিকা এবং কাস্টমাইজেশন সংক্রান্ত পরামর্শ হল Google Maps Platform API-এর সর্বোত্তম সমন্বয় যা Google সাজেস্ট করে। এটি প্রোডাক্ট লোকেটর ব্যবহারকারীদের দুর্দান্ত অভিজ্ঞতা প্রদান করে।
এই প্রয়োগ করার নির্দেশিকা অনুসরণ করে, আপনি গ্রাহকদের আপনার প্রোডাক্ট খুঁজে পেতে প্রয়োজনীয় বিস্তারিত তথ্য দেখতে সাহায্য করতে পারেন এবং তাদের সেই স্টোরের দিকনির্দেশ দিতে পারেন যেখানে তাদের আইটেম রয়েছে, তারা গাড়ি চালাচ্ছেন, সাইকেল চালাচ্ছেন, হাঁটছেন বা পাবলিক ট্রানজিট নিচ্ছেন।
API চালু করুন
প্রোডাক্ট লোকেটর প্রয়োগ করতে, আপনাকে Google Cloud কনসোলে নিম্নলিখিত API চালু করতে হবে। নিম্নলিখিত হাইপারলিঙ্ক আপনাকে Google Cloud কনসোলে পাঠায় যাতে আপনার বেছে নেওয়া প্রোজেক্টের জন্য প্রতিটি API চালু করতে পারেন:
সেট-আপ সম্পর্কে আরও তথ্যের জন্য, Google Maps Platform-এর ব্যবহার শুরু করা দেখুন।
প্রয়োগ করার নির্দেশিকা বিভাগ
এখানে নিম্নলিখিত প্রয়োগ ও কাস্টমাইজেশন সম্পর্কে আলোচনা করা হয়েছে:
- টিক চিহ্ন আইকন হল একটি মূল প্রয়োগের ধাপ।
- সমাধান আরও উন্নত করতে, স্টার আইকন হল একটি ঐচ্ছিক কিন্তু সাজেস্ট করা কাস্টমাইজেশন।
| Google Maps Platform-এর জায়গাগুলির সাথে স্টোরের লোকেশন অ্যাসোসিয়েট করুন | Google Maps Platform-এ কোনও জায়গার সাথে স্টোরের লোকেশন ম্যাচ করুন। | |
| ব্যবহারকারীর লোকেশন শনাক্ত করা | সব প্ল্যাটফর্মে ব্যবহারকারীর অভিজ্ঞতা উন্নত করতে এবং ন্যূনতম কীস্ট্রোকের মাধ্যমে ঠিকানা নির্ভুলভাবে লেখার জন্য টাইপ-অ্যাজ-ইউ-গো কার্যকারিতা যোগ করুন। | |
| সবচেয়ে কাছের স্টোর শনাক্ত করা | একাধিক উৎস ও গন্তব্যের জন্য ভ্রমণের দূরত্ব ও ভ্রমণের সময় গণনা করুন, বিকল্প হিসেবে হাঁটা, গাড়ি চালানো, পাবলিক ট্রানজিট বা সাইকেল চালানোর মতো বিভিন্ন ধরনের পরিবহনের উল্লেখ করুন। | |
| স্টোরের তথ্য ডিসপ্লে করুন | আপনার স্টোর সম্পর্কে ডেটা-সমৃদ্ধ তথ্য দেখান, যাতে ব্যবহারকারীরা আরও সহজে সেখানে যেতে পারেন। | |
| নেভিগেশন সংক্রান্ত দিকনির্দেশ প্রদান করা | হাঁটা, ড্রাইভিং, সাইকেল চালানো এবং পাবলিক ট্রানজিটের মতো বিভিন্ন ধরনের পরিবহন ব্যবহার করে উৎস থেকে গন্তব্যের দিকনির্দেশ ডেটা পান। | |
| মোবাইলে দিকনির্দেশ পাঠান | আপনার ওয়েবপেজে দিকনির্দেশ দেখানোর পাশাপাশি, আপনি ব্যবহারকারীর ফোনেও দিকনির্দেশ পাঠাতে পারেন যাতে তিনি Google Maps ব্যবহার করে নেভিগেট করতে পারেন। | |
| ইন্টার্যাক্টিভ ম্যাপে আপনার লোকেশন দেখানো | আপনার লোকেশন আলাদা করে দেখাতে কাস্টম ম্যাপ মার্কার তৈরি করুন এবং আপনার ব্র্যান্ডের রঙের সাথে ম্যাচ করে ম্যাপ স্টাইল করুন। ব্যবহারকারীদের আরও ভালভাবে নিজেদের ওরিয়েন্ট করতে সাহায্য করার জন্য আপনার ম্যাপে নির্দিষ্ট উল্লেখযোগ্য স্থান (POI) দেখান (বা লুকান) এবং ম্যাপে বিশৃঙ্খলা এড়াতে POI ঘনত্ব নিয়ন্ত্রণ করুন। | |
| কাস্টম লোকেশন ডেটা জায়গার বিবরণের সাথে একত্রিত করুন | সিদ্ধান্ত নেওয়ার জন্য ব্যবহারকারীদের ডেটার একটি সমৃদ্ধ সেট দিতে, আপনার নিজস্ব কাস্টম লোকেশনের বিবরণ জায়গার বিবরণের সাথে একত্রিত করুন। |
Google Maps Platform-এর জায়গার সাথে স্টোরের লোকেশন যুক্ত করা
জায়গার আইডি পান
| এই উদাহরণে এগুলি ব্যবহার করা হয়েছে: Places API (নতুন) | এছাড়াও উপলভ্য: JavaScript |
আপনি দেখতে পাবেন যে আপনার কাছে স্টোরের একটি ডেটাবেস আছে যেখানে বেসিক তথ্য আছে
যেমন সেই লোকেশনের নাম, ঠিকানা এবং ফোন নম্বর এবং আপনি
এটি Google Maps Platform-এ একটি জায়গার সাথে যুক্ত করতে চান যাতে আপনার ব্যবহারকারীরা
প্রোডাক্ট নিতে পারেন। ভৌগোলিক স্থানাঙ্ক এবং ব্যবহারকারীর অবদান রাখা তথ্য সহ সেই জায়গা সম্পর্কে Google Maps Platform-এর কাছে থাকা তথ্য পেতে, আপনার ডেটাবেসের প্রতিটি স্টোরের সাথে সম্পর্কিত প্লেস আইডি খুঁজুন। আপনি Places API (নতুন)-এ
টেক্সট সার্চ (নতুন) এন্ডপয়েন্ট-এ কল করতে পারেন এবং
ফিল্ড মাস্কে শুধু places.id ফিল্ডের জন্য অনুরোধ করতে পারেন (যা
টেক্সট
সার্চ এসেনশিয়াল আইডি-অনলি SKU ট্রিগার করে)।
Google-এর লন্ডন অফিসের জন্য প্লেস আইডি অনুরোধ করার উদাহরণ নিচে দেখানো হল:
curl -X POST -d '{
"textQuery" : "Google London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'আপনি আপনার স্টোরের বাকি ডেটার সাথে আপনার ডেটাবেসে এই স্থান আইডি স্টোর করতে পারেন এবং স্টোর সম্পর্কে তথ্যের অনুরোধ করার জন্য একটি দক্ষ উপায় হিসাবে এটি ব্যবহার করতে পারেন। জিওকোড, জায়গার বিবরণ ফিরিয়ে আনা এবং জায়গার দিকনির্দেশের অনুরোধ করার জন্য প্লেস আইডি ব্যবহার করার নির্দেশাবলী নিচে দেওয়া হল।
আপনার লোকেশন জিওকোড করুন
| এই উদাহরণে এগুলি ব্যবহার করা হয়েছে: Geocoding API | এছাড়াও উপলভ্য: JavaScript |
আপনার স্টোরের ডেটাবেসে রাস্তার ঠিকানা থাকলেও ভৌগোলিক স্থানাঙ্ক না থাকলে, Geocoding API ব্যবহার করে সেই ঠিকানার অক্ষাংশ ও দ্রাঘিমাংশ জেনে নিন, যাতে আপনার গ্রাহকের সবচেয়ে কাছাকাছি কোন স্টোর আছে তা হিসেব করতে পারেন। আপনি সার্ভার সাইডে স্টোর জিওকোড করতে, আপনার ডেটাবেসে অক্ষাংশ ও দ্রাঘিমাংশ স্টোর করতে এবং কমপক্ষে প্রতি ৩০ দিনে রিফ্রেশ করতে পারবেন।
Google-এর লন্ডন অফিসের জন্য যে প্লেস আইডি পাওয়া গেছে, Geocoding API ব্যবহার করে তার অক্ষাংশ ও দ্রাঘিমাংশ পাওয়ার উদাহরণ এখানে দেওয়া হল:
```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_productlocator_v1_a
```
ব্যবহারকারীর লোকেশন শনাক্ত করা
| এই উদাহরণে ব্যবহার করা হয়েছে: Maps JavaScript API-তে জায়গা অটোমেটিক সম্পূর্ণ করা | এছাড়াও উপলভ্য: Android | iOS |
প্রোডাক্ট লোকেটরের একটি মূল উপাদান হল আপনার ব্যবহারকারীর শুরুর লোকেশন শনাক্ত করা। ব্যবহারকারীকে তার শুরুর লোকেশন নির্দিষ্ট করার জন্য আপনি দুটি বিকল্প অফার করতে পারেন: তার সার্চের উৎস টাইপ করা বা ওয়েব ব্রাউজার জিওলোকেশন বা মোবাইল লোকেশন পরিষেবার জন্য অনুমতি দেওয়া।
অটো-কমপ্লিট ব্যবহার করে টাইপ করা এন্ট্রি ম্যানেজ করুন
আজকের ব্যবহারকারীরা Google Maps-এর কনজিউমার ভার্সনে অটোমেটিক সম্পূর্ণ করার টাইপ-অ্যাহেড কার্যকারিতায় অভ্যস্ত। এই কার্যকারিতা মোবাইল ডিভাইস এবং ওয়েবে Google Maps Platform Places লাইব্রেরি ব্যবহার করে যেকোনও অ্যাপ্লিকেশনে ইন্টিগ্রেট করা যেতে পারে। ব্যবহারকারী কোনও ঠিকানা টাইপ করলে, উইজেট ব্যবহার করে অটোকমপ্লিট ফিচার বাকি অংশ পূরণ করে দেয়। এছাড়াও, আপনি সরাসরি জায়গা অটোমেটিক সম্পূর্ণ করার ডেটা API ব্যবহার করে নিজের অটোমেটিক সম্পূর্ণ করার ফাংশনালিটি প্রদান করতে পারবেন।
নিচের উদাহরণে, Maps JavaScript API স্ক্রিপ্ট URL-এ libraries=places,marker প্যারামিটার যোগ করে আপনার সাইটে Places এবং Marker লাইব্রেরি যোগ করুন।
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places,marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a" defer></script>এরপর, আপনার পৃষ্ঠায় একটি কন্টেনার এলিমেন্ট যোগ করুন যেখানে
PlaceAutocompleteElement
উইজেট যোগ করা হবে:
<div id="autocomplete-container"></div>সবশেষে, PlaceAutocompleteElement উইজেট ইনিশিয়ালাইজ করুন এবং
কন্টেনারে এটি যোগ করুন। includedPrimaryTypes: ["geocode"]-এর মাধ্যমে
জায়গা
অটোমেটিক সম্পূর্ণ করার পূর্বাভাষ
সীমাবদ্ধ করলে, রাস্তার ঠিকানা, আশেপাশের এলাকা, শহর ও পিন কোড গ্রহণ করার জন্য
উইজেট কনফিগার করা হয়, যাতে ব্যবহারকারীরা তাদের যাত্রা শুরুর স্থান বর্ণনা করার জন্য
যেকোনও লেভেলের নির্দিষ্টতা ইনপুট করতে পারেন। কোনও ব্যবহারকারী একটি
পূর্বাভাস বেছে নিলে, gmp-select ইভেন্ট ট্রিগার হয় এবং আপনি
place.fetchFields() কল করে location ফিল্ডের জন্য অনুরোধ করতে পারেন
যেখানে ব্যবহারকারীর উৎসের অক্ষাংশ ও দ্রাঘিমাংশ থাকে। আপনি এই ম্যাপ কোঅর্ডিনেট ব্যবহার করে
আপনার লোকেশনের সাথে উৎসের সম্পর্ক নির্দেশ করবেন।
// Create the PlaceAutocompleteElement, restricting predictions to // geographical location types in the United Kingdom. const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement({ includedPrimaryTypes: ["geocode"], includedRegionCodes: ["gb"], }); placeAutocomplete.placeholder = "Enter starting address, city, or zip code"; document.getElementById("autocomplete-container").appendChild(placeAutocomplete); // When the user selects an address from the drop-down, // fetch the place details and search for the nearest stores. placeAutocomplete.addEventListener("gmp-select", async ({ placePrediction }) => { const place = placePrediction.toPlace(); await place.fetchFields({ fields: ["id", "location", "formattedAddress"], }); searchFromOrigin(place); }); }
এই উদাহরণে, ব্যবহারকারী ঠিকানা বেছে নেওয়ার পরে,
searchFromOrigin() ফাংশন শুরু হয়। এটি মিলে যাওয়া ফলাফলের লোকেশন নেয়, যা হল ব্যবহারকারীর লোকেশন, তারপর সেই কোঅর্ডিনেটকে উৎস হিসেবে ধরে নিয়ে সবচেয়ে কাছের লোকেশন সার্চ করে, যা সবচেয়ে কাছের স্টোর শনাক্ত করুন বিভাগে আলোচনা করা হয়েছে।
আপনার অ্যাপে জায়গা অটোমেটিক সম্পূর্ণ করার সুবিধা যোগ করার ভিডিও ওয়াকথ্রু দেখতে এটি বড় করুন:
ওয়েবসাইট
Android অ্যাপ
iOS অ্যাপ
ব্রাউজার জিওলোকেশন ব্যবহার করুন
HTML5 ব্রাউজার জিওলোকেশন অনুরোধ ও ম্যানেজ করতে, কীভাবে আমার লোকেশন ব্যবহার করুন উইন্ডো চালু করবেন তা দেখুন:
সবচেয়ে কাছের স্টোরগুলি শনাক্ত করুন
| এই উদাহরণে ব্যবহার করা হয়েছে: Routes Library, Maps JavaScript API | এছাড়াও উপলভ্য: Routes API |
ব্যবহারকারীর লোকেশন পাওয়ার পরে, আপনার স্টোরের লোকেশনের সাথে এটি তুলনা করতে পারবেন। Maps JavaScript API-এর Routes লাইব্রেরিতে
RouteMatrix
class-এর মাধ্যমে এটি করলে (অথবা Routes API-তে
Compute Route
Matrix ফিচার) আপনার ব্যবহারকারীদের ড্রাইভিং টাইম বা রাস্তার দূরত্ব অনুযায়ী তাদের জন্য সবচেয়ে সুবিধাজনক
লোকেশন বেছে নিতে সাহায্য করে।
লোকেশন তালিকা সাজানোর স্ট্যান্ডার্ড পদ্ধতি হল দূরত্ব অনুযায়ী সাজানো। প্রায়শই এই দূরত্ব ব্যবহারকারী থেকে লোকেশন পর্যন্ত সরলরেখা ব্যবহার করে সহজেই গণনা করা হয়, তবে এটি বিভ্রান্তিকর হতে পারে। সরলরেখাটি কোনও দুর্গম নদীর উপর দিয়ে বা ব্যস্ত রাস্তার মধ্য দিয়ে যেতে পারে, যেখানে অন্য কোনও লোকেশন আরও সুবিধাজনক হতে পারে। কয়েক কিলোমিটারের মধ্যে আপনার একাধিক লোকেশন থাকলে এটি গুরুত্বপূর্ণ।
RouteMatrix.computeRouteMatrix পদ্ধতিটি শুরু এবং গন্তব্য লোকেশনের একটি তালিকা নিয়ে কাজ করে এবং শুধু ভ্রমণের দূরত্বই নয়,
তাদের মধ্যে ভ্রমণের সময়ও রিটার্ন করে। ব্যবহারকারীর ক্ষেত্রে, যাত্রা শুরুর জায়গা হল যেখানে
তিনি বর্তমানে আছেন অথবা তার পছন্দসই শুরুর জায়গা এবং গন্তব্য হল
লোকেশন। যাত্রা শুরুর জায়গা ও গন্তব্য কোঅর্ডিনেট পেয়ার,
প্লেস আইডি বা ঠিকানা হিসেবে উল্লেখ করা যেতে পারে। আপনি
RouteMatrix.computeRouteMatrix-এর সাথে
TRAFFIC_AWARE-এর মতো রাউটিং সংক্রান্ত পছন্দ ব্যবহার করে বর্তমান বা ভবিষ্যতের ড্রাইভিং
সময়ের উপর ভিত্তি করে ফলাফল দেখতে পারেন।
নিম্নলিখিত উদাহরণটি Routes Library, Maps JavaScript API-তে RouteMatrix.computeRouteMatrix কল করে, ব্যবহারকারীর উৎস এবং একবারে সর্বাধিক ২৫টি স্টোরের লোকেশন নির্দিষ্ট করে।
async function getDistances(originLocation) { const { RouteMatrix } = await google.maps.importLibrary("routes"); const request = { origins: [originLocation], destinations: stores.slice(0, 25).map((store) => store.location), travelMode: google.maps.TravelMode.DRIVING, routingPreference: "TRAFFIC_AWARE", fields: ["distanceMeters", "durationMillis", "condition"], }; return RouteMatrix.computeRouteMatrix(request); } function update(location) { if (!location) { return; } // ... // sort by spherical distance stores.sort((a, b) => { return ( google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(a.location), location ) - google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(b.location), location ) ); }); // display travel distance and time getDistances(location) .then(({ matrix }) => { const items = matrix.rows[0].items; for (let i = 0; i < items.length; i++) { if (items[i].condition === "ROUTE_EXISTS") { stores[i].travelDistance = items[i].distanceMeters; stores[i].travelDuration = items[i].durationMillis; } } }) .finally(() => { renderCards(stores); autocompleteInput.disabled = false; isUpdateInProgress = false; }); }
আপনার ইনভেনটরি ডেটাবেসের উপর ভিত্তি করে, আশেপাশের প্রতিটি লোকেশনের জন্য আপনি প্রোডাক্টের স্টক স্ট্যাটাস দেখাতে পারবেন।
স্টোরের তথ্য দেখানো
| এই উদাহরণে ব্যবহার করা হয়েছে: Places Library, Maps JavaScript API | এছাড়াও উপলভ্য: Android-এর জন্য Places SDK | iOS-এর জন্য Places SDK | Places API (নতুন) |
আপনি জায়গার বিবরণ যেমন যোগাযোগের তথ্য, খোলা থাকার সময় এবং বর্তমানে খোলা আছে কিনা তা শেয়ার করতে পারেন। এর ফলে গ্রাহকরা তাদের পছন্দের লোকেশন বেছে নিতে বা অর্ডার চূড়ান্ত করতে পারবেন।
জায়গার বিবরণ পেতে Maps JavaScript API-তে কল করার পরে, আপনি উত্তর ফিল্টার ও রেন্ডার করতে পারবেন।
জায়গার বিবরণ সংক্রান্ত অনুরোধ করতে, আপনার প্রতিটি লোকেশনের জন্য জায়গার আইডি প্রয়োজন হবে। আপনার লোকেশনের জায়গা সংক্রান্ত আইডি পেতে জায়গা সংক্রান্ত আইডি পান বিকল্প দেখুন।
নিম্নলিখিত জায়গার বিবরণ সংক্রান্ত অনুরোধ Place ক্লাস ব্যবহার করে Google London-এর জায়গা আইডির জন্য নাম, কোঅর্ডিনেট, ওয়েবসাইট, ফোন নম্বর, রেটিং ও সময় ফেরত পাঠায়:
const place = new google.maps.places.Place({ id: 'ChIJVSZzVR8FdkgRTyQkxxLQmVU', });await place.fetchFields({ fields: [ 'displayName', 'nationalPhoneNumber', 'location', 'regularOpeningHours', 'rating', 'utcOffsetMinutes', 'websiteURI', ], });
createMarker(place);
প্রোডাক্ট লোকেটর উন্নত করুন
আপনার ব্যবসা বা ব্যবহারকারীর প্রয়োজনের উপর নির্ভর করে, আপনি ব্যবহারকারীর অভিজ্ঞতা আরও উন্নত করতে পারেন।
নেভিগেট করার দিকনির্দেশ প্রদান করুন
| এই উদাহরণে ব্যবহার করা হয়েছে: Routes Library, Maps JavaScript API | এছাড়াও উপলভ্য: Routes API Android ও iOS-এ ব্যবহারের জন্য ওয়েব পরিষেবা, সরাসরি অ্যাপ্লিকেশন থেকে অথবা দূরবর্তীভাবে সার্ভার প্রক্সির মাধ্যমে |
আপনার সাইট বা অ্যাপ্লিকেশন থেকে ব্যবহারকারীদের দিকনির্দেশ দেখালে, আপনার ব্যবহারকারীদের আপনার সাইট থেকে অন্য কোথাও নেভিগেট করতে হবে না এবং অন্যান্য পৃষ্ঠাগুলির সাথে বিভ্রান্ত হতে হবে না বা ম্যাপে প্রতিযোগীদের দেখতে হবে না। Routes API-এর মাধ্যমে, আপনি জ্বালানি বা বিদ্যুৎ ব্যবহার অনুমান করতে এবং ভ্রমণের পরিবেশগত প্রভাব দেখাতে ইকো-ফ্রেন্ডলি রুট-এর জন্য অনুরোধ করতে পারেন।
এছাড়াও, Routes Library, Maps JavaScript API-এর Route
class-এ
createPolylines() এবং
createWaypointAdvancedMarkers()-এর মতো পদ্ধতি আছে যা আপনাকে ফলাফল প্রসেস করতে
এবং ম্যাপে তা দেখাতে সাহায্য করে।
ম্যাপে রুট দেখানোর জন্য অনুরোধ করা এবং তা দেখানোর উদাহরণ নিচে দেওয়া হল। স্যাম্পেল সম্পর্কে আরও তথ্য পেতে, রুট পান দেখুন।
মোবাইলে দিকনির্দেশ পাঠান
ব্যবহারকারীদের জন্য কোনও লোকেশনে পৌঁছানো আরও সহজ করতে, আপনি তাদের দিকনির্দেশের লিঙ্ক টেক্সট বা ইমেল করতে পারেন। তিনি এটিতে ক্লিক করলে, তার ফোনে Google Maps অ্যাপ ইনস্টল করা থাকলে সেটি চালু হবে অথবা তার ডিভাইসের ওয়েব ব্রাউজারে maps.google.com লোড হবে। এই দুটি অভিজ্ঞতাই ব্যবহারকারীকে গন্তব্যে পৌঁছানোর জন্য ভয়েস নির্দেশিকা সহ ধাপে ধাপে নেভিগেশন ব্যবহার করার বিকল্প প্রদান করে।
destination প্যারামিটার হিসেবে URL-এনকোড করা জায়গার নাম এবং destination_place_id প্যারামিটার হিসেবে জায়গার আইডি সহ
নিম্নলিখিতর মতো দিকনির্দেশ URL তৈরি করতে
Maps URL ব্যবহার করুন। Maps URL কম্পোজ বা ব্যবহার করার জন্য কোনও খরচ হয় না, তাই URL-এ API key যোগ করার প্রয়োজন নেই।
https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU
আপনি গন্তব্যের মতো একই ঠিকানা ফর্ম্যাট ব্যবহার করে ঐচ্ছিকভাবে একটি origin কোয়েরি প্যারামিটার প্রদান করতে পারেন। তবে, এটি বাদ দিলে, দিকনির্দেশ ব্যবহারকারীর বর্তমান লোকেশন থেকে শুরু হয়, যা আপনার প্রোডাক্ট লোকেটর অ্যাপ ব্যবহার করার লোকেশন থেকে আলাদা হতে পারে।
Maps URL
অতিরিক্ত কোয়েরি প্যারামিটার বিকল্প প্রদান করে, যেমন নেভিগেশন চালু করে দিকনির্দেশ শুরু করার জন্য travelmode এবং
dir_action=navigate।
এই ক্লিক করার মতো লিঙ্ক, যা আগের উদাহরণ URL-কে আরও বড় করে,
origin-কে লন্ডনের ফুটবল স্টেডিয়াম হিসেবে সেট করে এবং
travelmode=transit ব্যবহার করে গন্তব্যে পৌঁছানোর জন্য পাবলিক ট্রানজিটের দিকনির্দেশ
প্রদান করে।
এই URL সহ টেক্সট বা ইমেল পাঠাতে, আমরা বর্তমানে twilio-এর মতো থার্ড-পার্টি অ্যাপ্লিকেশন ব্যবহার করার সাজেশন দিই। আপনি App Engine ব্যবহার করলে, এসএমএস মেসেজ বা ইমেল পাঠানোর জন্য থার্ড-পার্টি কোম্পানি ব্যবহার করতে পারবেন। আরও তথ্যের জন্য, থার্ড-পার্টি পরিষেবার মাধ্যমে মেসেজ পাঠানো দেখুন।
ইন্টার্যাক্টিভ ম্যাপে আপনার লোকেশন দেখানো
ডায়নামিক ম্যাপ ব্যবহার করা
| এই উদাহরণে ব্যবহার করা হয়েছে: Maps JavaScript API | এছাড়াও উপলভ্য: Android | iOS |
লোকেটর হল ব্যবহারকারীর অভিজ্ঞতার একটি গুরুত্বপূর্ণ অংশ। তবে, কিছু সাইটে এমনকি একটি সাধারণ ম্যাপও নাও থাকতে পারে, যার ফলে ব্যবহারকারীদের কাছাকাছি কোনও লোকেশন খুঁজে পেতে সাইট বা অ্যাপ ছেড়ে যেতে হয়। এর অর্থ হল, ব্যবহারকারীকে প্রয়োজনীয় তথ্য পেতে এক পৃষ্ঠা থেকে অন্য পৃষ্ঠায় নেভিগেট করতে হয় বলে তিনি সাব-অপ্টিমাল অভিজ্ঞতা পান। পরিবর্তে, আপনি নিজের অ্যাপ্লিকেশনে ম্যাপ এম্বেড ও কাস্টমাইজ করে এই অভিজ্ঞতা উন্নত করতে পারেন।
আপনার পৃষ্ঠায় ডায়নামিক ম্যাপ যোগ করা—অর্থাৎ, এমন একটি ম্যাপ যা ব্যবহারকারীরা ঘুরিয়ে-ফিরিয়ে দেখতে, জুম-ইন ও জুম-আউট করতে এবং বিভিন্ন লোকেশন ও আকর্ষণীয় স্থান সম্পর্কে বিবরণ পেতে পারেন—কয়েক লাইন কোডের মাধ্যমে করা যেতে পারে।
প্রথমে, আপনাকে পৃষ্ঠায় Maps JavaScript API অন্তর্ভুক্ত করতে হবে।
এটি আপনার HTML পৃষ্ঠায় নিম্নলিখিত স্ক্রিপ্ট লিঙ্ক করার মাধ্যমে করা হয়, যার মধ্যে
libraries=marker অন্তর্ভুক্ত থাকে যাতে আপনি ম্যাপে
উন্নত
মার্কার যোগ করতে পারেন।
<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a"></script>URL-টি জাভাস্ক্রিপ্ট initMap ফাংশনকে রেফারেন্স করে যা পৃষ্ঠা লোড হওয়ার সময়
রান করে। এছাড়াও, আপনি যে নির্দিষ্ট দেশের জন্য ম্যাপ তৈরি করছেন,
সেখানে যাতে ম্যাপটি সঠিকভাবে ফর্ম্যাট করা হয়, তা নিশ্চিত করতে URL-এ
আপনার ম্যাপের ভাষা বা অঞ্চল উল্লেখ করতে পারেন। এছাড়াও, অঞ্চল সেট করলে, মার্কিন যুক্তরাষ্ট্রের বাইরে ব্যবহার করা অ্যাপের আচরণ আপনার সেট করা অঞ্চলের প্রতি পক্ষপাতদুষ্ট হয়। যেসব ভাষা ও অঞ্চলে উপলভ্য তার সম্পূর্ণ তালিকা দেখতে
Google Maps Platform কভারেজের বিবরণ দেখুন এবং
region
প্যারামিটার ব্যবহার সম্পর্কে আরও জানুন।
এরপর, পৃষ্ঠায় আপনার ম্যাপ যোগ করার জন্য একটি HTML div প্রয়োজন।
এই জায়গায় ম্যাপ দেখানো হবে।
<div id="map"></div>পরবর্তী ধাপে আপনার ম্যাপের প্রাথমিক কার্যকারিতা সেট করতে হবে। এটি স্ক্রিপ্ট URL-এ নির্দিষ্ট করা
initMap স্ক্রিপ্ট ফাংশনে করা হয়। এই স্ক্রিপ্টে,
নিচের উদাহরণে দেখানো হয়েছে, আপনি প্রাথমিক লোকেশন, একটি
ম্যাপ আইডি (উন্নত মার্কার এবং ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিংয়ের জন্য
প্রয়োজন),
ম্যাপের ধরন এবং
আপনার ব্যবহারকারীদের জন্য ম্যাপে কোন কন্ট্রোল উপলভ্য আছে তা সেট করতে পারবেন। লক্ষ্য করুন যে
getElementById() পূর্ববর্তী "ম্যাপ" div
আইডিকে রেফারেন্স করে।
function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 12, center: { lat: 51.485925, lng: -0.129500 }, mapId: "DEMO_MAP_ID", zoomControl: false }); }
লোকেটরের ক্ষেত্রে, আপনি সাধারণত প্রাথমিক লোকেশন, কেন্দ্রবিন্দু বা সীমানা এবং জুম লেভেল (ম্যাপে সেই লোকেশন কতটা জুম করা হয়েছে) সেট করতে আগ্রহী হন। কন্ট্রোল টিউন করার মতো অন্যান্য বেশিরভাগ এলিমেন্ট ঐচ্ছিক, কারণ আপনিই ম্যাপের সাথে ইন্টার্যাকশনের লেভেল নির্ধারণ করেন।
আপনার মানচিত্র কাস্টমাইজ করুন
আপনি বিভিন্ন উপায়ে আপনার ম্যাপের চেহারা এবং বিবরণ পরিবর্তন করতে পারেন। যেমন, আপনি এগুলি করতে পারবেন:
- ডিফল্ট ম্যাপ পিন পরিবর্তন করতে আপনার নিজস্ব কাস্টম মার্কার তৈরি করুন।
- আপনার ব্র্যান্ডের সাথে মানানসই করতে ম্যাপ ফিচারের রঙ পরিবর্তন করুন।
- আপনি কোন কোন আগ্রহের স্থান (আকর্ষণ, খাবার, থাকার জায়গা ইত্যাদি) এবং কত ঘনত্বে দেখাবেন তা নিয়ন্ত্রণ করুন, ব্যবহারকারীদের নিকটতম লোকেশনে পৌঁছাতে সাহায্য করে এমন ল্যান্ডমার্ক হাইলাইট করার সময় আপনার লোকেশনে ব্যবহারকারীর মনোযোগ ফোকাস করতে দেয়।
কাস্টম ম্যাপ মার্কার তৈরি করা
আপনি ডিফল্ট পিন ব্যাকগ্রাউন্ড, বর্ডার বা গ্লিফ কালার পরিবর্তন করে (যেমন, কোনও লোকেশন বর্তমানে খোলা আছে কিনা তা নির্দেশ করতে), মার্কারটি আপনার ব্র্যান্ডের লোগোর মতো কাস্টম গ্রাফিক ইমেজ দিয়ে প্রতিস্থাপন করে বা কাস্টম HTML এবং CSS মার্কার তৈরি করে আপনার উন্নত মার্কার কাস্টমাইজ করতে পারেন। তথ্য উইন্ডো বা পপ-আপ উইন্ডো ব্যবহারকারীদের অতিরিক্ত তথ্য প্রদান করতে পারে, যেমন খোলা থাকার সময়, ফোন নম্বর বা ফটো।
নিচে একটি স্যাম্পেল ম্যাপ দেওয়া হল যা কাস্টম গ্রাফিক মার্কার ব্যবহার করে। ( Maps JavaScript API কাস্টম গ্রাফিক মার্কার সংক্রান্ত বিষয়ে সোর্স কোড দেখুন।)
বিস্তারিত তথ্যের জন্য, JavaScript (ওয়েব), Android এবং iOS-এর জন্য উন্নত মার্কার ডকুমেন্টেশন দেখুন।
আপনার ম্যাপ স্টাইল করুন
Google Maps Platform আপনাকে এমনভাবে ম্যাপ স্টাইল করতে দেয় যা ব্যবহারকারীদের সবচেয়ে কাছের লোকেশন খুঁজে পেতে, যত তাড়াতাড়ি সম্ভব সেখানে পৌঁছাতে এবং আপনার ব্র্যান্ডকে আরও শক্তিশালী করতে সাহায্য করে। যেমন, আপনার ব্র্যান্ডিংয়ের সাথে ম্যাচ করার জন্য ম্যাপের রঙ পরিবর্তন করতে পারবেন এবং ব্যবহারকারীদের কাছে দৃশ্যমান আগ্রহের স্থানগুলি নিয়ন্ত্রণ করার মাধ্যমে ম্যাপে মনোযোগ বিক্ষিপ্ত হওয়ার সম্ভাবনা কমাতে পারবেন। এছাড়াও, Google Maps Platform-এ ম্যাপের একাধিক স্টার্টার টেমপ্লেট রয়েছে, যার মধ্যে কয়েকটি বিভিন্ন ইন্ডাস্ট্রির জন্য অপ্টিমাইজ করা হয়েছে, যেমন ভ্রমণ, লজিস্টিক, রিয়েল এস্টেট ও রিটেল।
আপনি Google Cloud Console-এ ম্যাপ স্টাইল তৈরি বা পরিবর্তন করতে পারবেন আপনার প্রোজেক্টের ম্যাপ স্টাইল পৃষ্ঠায়।
Cloud কনসোলে ম্যাপ স্টাইল তৈরি ও স্টাইলিংয়ের অ্যানিমেশন দেখতে বড় করুন:
ইন্ডাস্ট্রি ম্যাপ স্টাইল
এই অ্যানিমেশনটি আপনাকে আগে থেকে নির্ধারিত ইন্ডাস্ট্রি-নির্দিষ্ট ম্যাপ স্টাইল দেখায় যা আপনি ব্যবহার করতে পারেন। এই স্টাইলগুলি প্রতিটি ধরনের ইন্ডাস্ট্রির জন্য একটি অনুকূল সূচনা বিন্দু প্রদান করে। যেমন, রিটেল ম্যাপ স্টাইল ম্যাপে উল্লেখযোগ্য স্থান কম দেখায়, যার ফলে ব্যবহারকারীরা আপনার লোকেশন এবং ল্যান্ডমার্কের উপর ফোকাস করতে পারেন। এর ফলে তারা যত তাড়াতাড়ি এবং আত্মবিশ্বাসের সাথে সম্ভব নিকটতম লোকেশনে পৌঁছাতে পারেন।
উল্লেখযোগ্য স্থান কন্ট্রোল
এই অ্যানিমেশন উল্লেখযোগ্য স্থানের জন্য মার্কারের রঙ সেট করে এবং ম্যাপ স্টাইলে POI-এর ঘনত্ব বাড়ায়। ঘনত্ব যত বেশি হবে, ম্যাপে তত বেশি POI মার্কার দেখা যাবে।
প্রতিটি ম্যাপ স্টাইলের নিজস্ব আইডি আছে। আপনি Cloud কনসোলে কোনও স্টাইল প্রকাশ করার পরে, আপনার কোডে সেই ম্যাপ আইডি রেফারেন্স করেন—যার অর্থ হল আপনি নিজের অ্যাপ রিফ্যাক্টর না করেই রিয়েল টাইমে ম্যাপ স্টাইল আপডেট করতে পারবেন। নতুন লুক অটোমেটিক আগে থেকে থাকা অ্যাপ্লিকেশনে দেখা যাবে এবং প্ল্যাটফর্ম জুড়ে ব্যবহার করা হবে। Maps JavaScript API ব্যবহার করে কীভাবে ওয়েব পেজে ম্যাপ আইডি যোগ করতে হয় তা নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন।
স্ক্রিপ্ট URL-এ এক বা একাধিক map_ids অন্তর্ভুক্ত করার মাধ্যমে, Maps JavaScript API অটোমেটিক সেইসব স্টাইল উপলভ্য করে
যাতে আপনি কোডে সেইসব স্টাইল কল করলে আরও দ্রুত ম্যাপ রেন্ডার করা যায়।
<script
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&map_ids=MAP_IDs&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a">
</script>নিম্নলিখিত কোডটি ওয়েব পেজে একটি সাজানো মানচিত্র দেখায়। (পৃষ্ঠায় যেখানে ম্যাপ দেখানো হবে,
সেখানে HTML <div id="map"></div> এলিমেন্ট দেখানো হয়নি।)
map = new google.maps.Map(document.getElementById('map'), { center: {lat: 51.485925, lng: -0.129500}, zoom: 12, mapId: '1234abcd5678efgh' });
ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং JavaScript (ওয়েব), Android, এবং iOS-এ অন্তর্ভুক্ত করার ব্যাপারে আরও জানুন।
জায়গার বিবরণের সাথে কাস্টম লোকেশন ডেটা একত্রিত করা
আগের ইন্টার্যাক্টিভ ম্যাপে আপনার লোকেশন দেখান বিভাগে আপনার লোকেশন সম্পর্কে ব্যবহারকারীদের বিস্তারিত তথ্য দিতে, 'জায়গার বিবরণ' ব্যবহার করার ব্যাপারে বর্ণনা করা হয়েছে, যেমন খোলা থাকার সময়, ফটো ও রিভিউ।
Places API (নতুন)-এ বিভিন্ন ডেটা ফিল্ডের দাম ও SKU স্তর বোঝা সহায়ক। আপনার খরচ ম্যানেজ করার একটি কৌশল হল, আপনার লোকেশন সম্পর্কে আগে থেকে থাকা তথ্যের সাথে Google Maps থেকে পাওয়া নতুন তথ্য একত্রিত করা, যেমন সাময়িক বন্ধ, ছুটির দিনে খোলা থাকার সময় এবং ব্যবহারকারীর রেটিং, ফটো ও রিভিউ। আপনার স্টোরের যোগাযোগের তথ্য আগে থেকেই থাকলে, আপনাকে জায়গার বিবরণ থেকে সেইসব ফিল্ডের জন্য অনুরোধ করতে হবে না এবং আপনি যে ফিল্ডগুলি দেখাতে চান শুধুমাত্র সেগুলি আনার জন্য আপনার ফিল্ড মাস্ক সীমাবদ্ধ করতে পারেন।
জায়গার বিবরণের পরিবর্তে বা তার সাথে যোগ করার জন্য আপনার কাছে নিজস্ব জায়গার ডেটা থাকতে পারে। ফুল-স্ট্যাক লোকেটরের জন্য কোডল্যাব আপনার নিজের লোকেশনের বিবরণ স্টোর ও ফিরিয়ে আনার জন্য ডেটাবেসের সাথে GeoJSON ব্যবহার করার উদাহরণ প্রদান করে।