এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ম্যাপ ইউআরএল বা প্লেস এপিআই সহ ব্যবহারকারীদেরকে Google ম্যাপ স্থানের বিবরণ এবং দিকনির্দেশে সরাসরি পাঠান

আজকের অবস্থান-সচেতন বিশ্বে, ব্যবহারকারীরা স্থানের তথ্য, দিকনির্দেশনা এবং নেভিগেশনে নির্বিঘ্ন অ্যাক্সেস আশা করেন। মেসেঞ্জার অ্যাপ, স্থানীয় পরিস্থিতি আবিষ্কারের অ্যাপ, লজিস্টিকস ও পরিবহন প্ল্যাটফর্ম, ট্র্যাভেল প্ল্যানার বা রিয়েল এস্টেট লিস্টিং প্ল্যাটফর্ম—যে মাধ্যমেই হোক না কেন, ব্যবহারকারীদের প্রায়শই দ্রুত অবস্থানের বিবরণ দেখতে বা 'এ' থেকে 'বি'-তে যাওয়ার সেরা পথ খুঁজে বের করার প্রয়োজন হয়। যদিও ডেভেলপাররা তাদের নিজস্ব ইন-অ্যাপ অভিজ্ঞতা তৈরি করতে পারেন, গুগল ম্যাপসের ব্যাপক এবং পরিচিত ইন্টারফেস ব্যবহার করলে একটি উন্নততর অভিজ্ঞতা পাওয়া যায়।

একটি নির্বিঘ্ন ব্যবহারকারী অভিজ্ঞতার জন্য একটি সুগঠিত গুগল ম্যাপস ইউআরএল অপরিহার্য। ভুল ইউআরএল এই অভিজ্ঞতাকে ব্যাহত করে, যা ব্যবহারকারীদের ভুল স্থানে নিয়ে যায়, নির্দিষ্ট বিবরণের পরিবর্তে একটি সাধারণ মানচিত্র দেখায়, অথবা এমনকি একটি ব্রোকেন লিঙ্কের কারণ হয়। এটি ব্যবহারকারীদের হতাশ করে এবং তাদের লক্ষ্য অর্জনে বাধা দেয়। উদাহরণস্বরূপ, একটি বৈধ ম্যাপস ইউআরএল থাকা সত্ত্বেও, কোনো নির্দিষ্ট ব্যবসা সম্পর্কে বিস্তারিত তথ্য আশা করা একজন ব্যবহারকারী কোনো প্রাসঙ্গিক তথ্য ছাড়াই একটি সাধারণ মানচিত্র দেখতে পারেন। নিচের উদাহরণটি দেখুন:

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

এই ম্যাপস ইউআরএলটি গুগল ম্যাপস খোলার জন্য এবং অক্ষাংশ ও দ্রাঘিমাংশের ভিত্তিতে অবস্থান দেখানোর জন্য বৈধ। তবে এটি ব্যবহারকারীদের কোনো নির্দিষ্ট স্থান সম্পর্কে বিস্তারিত তথ্য প্রদান করে না।

শুধুমাত্র অক্ষাংশ এবং দ্রাঘিমাংশ ব্যবহার করে অনুসন্ধান করুন

সঠিক ইউআরএল-এর মাধ্যমে আপনার অ্যাপ্লিকেশনকে গুগল ম্যাপস-এর সাথে নির্বিঘ্নে সংযুক্ত করুন।

গুগল ম্যাপসে স্থানের বিবরণ পৃষ্ঠাটি খুলুন

একটি অনন্য স্থানের নাম সহ একটি ম্যাপস ইউআরএল ব্যবহারকারীদের গুগল ম্যাপসে সেই স্থানের বিস্তারিত পৃষ্ঠায় নিয়ে যায়।

গুগল ম্যাপস প্ল্যাটফর্ম (GMP) সঠিক ইউআরএল (URL) তৈরির জন্য দুটি প্রধান পদ্ধতি প্রদান করে: প্লেসেস এপিআই (নতুন), যার জন্য একটি এপিআই কী (API key) প্রয়োজন, এবং ম্যাপস ইউআরএল (Maps URLs), যা বিনামূল্যে এবং এর জন্য কোনো কী-এর প্রয়োজন হয় না। নিম্নলিখিত সমাধানগুলো বিভিন্ন পরিস্থিতি এবং ব্যবহারের ক্ষেত্রকে সম্বোধন করে:

GMP Places API(New)-এর googleMapsUri বা googleMapsLinks ফিল্ড ব্যবহার করা

জিএমপি প্লেসেস এপিআই (নতুন) একটি নির্দিষ্ট স্থান সম্পর্কে বিস্তারিত তথ্য প্রদান করে। যখন ফিল্ড মাস্ক -এ উল্লেখ করে googleMapsUri বা googleMapsLinks ফিল্ডের জন্য অনুরোধ করা হয়, তখন এপিআই রেসপন্সে একটি প্লেস অবজেক্ট অন্তর্ভুক্ত থাকে। এই অবজেক্টটিতে আগে থেকে ফরম্যাট করা ইউআরএল থাকে, যা ব্যবহার করে গুগল ম্যাপস-এ সরাসরি সংশ্লিষ্ট ভিউ, যেমন স্থানের বিস্তারিত ভিউ, খোলা যায়।

উদাহরণ:

স্থানের বিবরণ অনুরোধ

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

স্থানের বিবরণের প্রতিক্রিয়া:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

উপরের উদাহরণে ChIJ3S-JXmauEmsRUcIaWtf4MzE হলো সিডনি অপেরা হাউসের প্লেস আইডি। প্লেস আইডি হলো একটি টেক্সচুয়াল আইডেন্টিফায়ার যা গুগল প্লেসেস ডেটাবেস এবং গুগল ম্যাপসে কোনো স্থানকে অনন্যভাবে শনাক্ত করে।

বিনামূল্যে স্থান আইডি পুনরুদ্ধার

প্রোগ্রামের মাধ্যমে প্লেস আইডি পেতে, আপনি প্লেসেস এপিআই-এর টেক্সট সার্চ (আইডি অনলি) কার্যকারিতাটি ব্যবহার করতে পারেন। প্লেস আইডি পাওয়ার জন্য এটি একটি বিনা খরচের পদ্ধতি। প্লেস আইডি এবং প্লেস এপিআই (নতুন) অনুরোধ সম্পর্কে আরও জানুন।

স্থান এপিআই টেক্সট অনুসন্ধান (শুধুমাত্র আইডি) অনুরোধ:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-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'

স্থান এপিআই টেক্সট সার্চ (শুধুমাত্র আইডি) এর প্রতিক্রিয়া:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

ব্যবহারকারী যখন ম্যাপে কোনো POI-তে ক্লিক বা ট্যাপ করেন, তখন প্লেস আইডিগুলোও পাওয়া যায়। ক্লিকযোগ্য POI আইকন সম্পর্কে আরও বিস্তারিত জানুন ( জাভাস্ক্রিপ্ট , অ্যান্ড্রয়েড , আইওএস )।

বাস্তবায়ন

Places API ব্যবহার করার সময়, ডেভেলপাররা রেসপন্স থেকে খুব সহজেই googleMapsUri বা googleMapsLinks ফিল্ডটি এক্সট্র্যাক্ট করে তা ব্যবহার করে Google Maps অ্যাপে অথবা অ্যাপটি ইনস্টল করা না থাকলে ব্রাউজারে সংশ্লিষ্ট ভিউটি চালু করতে পারেন।

বৈশিষ্ট্য	বর্ণনা
দিকনির্দেশনাউরি	ব্যবহারকারীর বর্তমান অবস্থান থেকে এই স্থানে যাওয়ার দিকনির্দেশনা দেখতে গুগল ম্যাপস খোলার লিঙ্ক।
প্লেসউরি	এই স্থানটির বিস্তারিত তথ্যের গুগল ম্যাপস পেজটি খোলার লিঙ্ক।
writeAreviewUri	এই জায়গাটির রিভিউ লেখার পৃষ্ঠায় যাওয়ার জন্য গুগল ম্যাপস লিঙ্ক।
উরি পর্যালোচনা	এই জায়গাটির রিভিউ পেজটি গুগল ম্যাপে খোলার লিঙ্ক।
ফটোউরি	এই জায়গার ফটো পেজটি গুগল ম্যাপে খোলার লিঙ্ক।

ডেভেলপার নির্দেশিকাটি দেখুন এবং আজই ফিচারটি ব্যবহার করে দেখুন।

মানচিত্রের ইউআরএল ব্যবহার করা

ম্যাপস ইউআরএল ব্যবহার করে, আপনি গুগল ম্যাপস চালু করতে, অনুসন্ধান করতে, দিকনির্দেশনা ও নেভিগেশন পেতে এবং মানচিত্রের দৃশ্য ও প্যানোরামিক ছবি প্রদর্শন করতে একটি সার্বজনীন, ক্রস-প্ল্যাটফর্ম ইউআরএল তৈরি করতে পারেন। ব্যবহৃত প্ল্যাটফর্ম নির্বিশেষে ইউআরএল সিনট্যাক্স একই থাকে। ম্যাপস ইউআরএল ব্যবহার করার জন্য আপনার কোনো গুগল এপিআই কী-এর প্রয়োজন নেই।

উপলব্ধ ম্যাপ অ্যাকশনগুলো হলো:

সার্চ ফাংশনটি একটি গুগল ম্যাপস অ্যাপ চালু করে অথবা অ্যাপটি ইনস্টল করা না থাকলে একটি ব্রাউজারে কোনো নির্দিষ্ট স্থানের পিন প্রদর্শন করে, কিংবা একটি সাধারণ অনুসন্ধান করে এবং ফলাফল দেখানোর জন্য একটি মানচিত্র চালু করে।
ডাইরেকশনস ফাংশনটি একটি গুগল ম্যাপস অ্যাপ চালু করে, অথবা অ্যাপটি ইনস্টল করা না থাকলে ব্রাউজারে চালু করে, যা বিভিন্ন বিন্দুর মধ্যে দিকনির্দেশনা দেখায় অথবা মোবাইল ডিভাইসের জন্য গুগল ম্যাপসে টার্ন-বাই-টার্ন নেভিগেশন সক্ষম করে।
স্ট্রিট ভিউ প্যানোরামা ফাংশনটি আপনাকে স্ট্রিট ভিউ ছবিগুলোকে ইন্টারেক্টিভ প্যানোরামা হিসেবে প্রদর্শন করার জন্য একটি ভিউয়ার চালু করতে দেয়।

আরও ফাংশন ও উদাহরণ জানতে GMP Maps URLs-এর ডেভেলপার ডকুমেন্টেশন দেখুন।

এখানে আমরা ম্যাপস ইউআরএল-এর দুটি মূল কার্যকারিতা নিয়ে বিস্তারিত আলোচনা করব:

গুগল ম্যাপে স্থানের বিবরণ প্রদর্শন: এই বিভাগে ব্যাখ্যা করা হয়েছে কীভাবে এমন ইউআরএল (URL) তৈরি করতে হয় যা গুগল ম্যাপে একটি নির্দিষ্ট অবস্থানের বিবরণ প্রদর্শন করবে। এতে প্লেস আইডি (Place ID) এবং সুনির্দিষ্ট কোয়েরি (precision queries) ব্যবহার করে কীভাবে অ-অনন্য নামের স্থানগুলির সাথে কাজ করতে হয়, তারও বিস্তারিত বর্ণনা দেওয়া হয়েছে।
ম্যাপ ইউআরএল ব্যবহার করে দিকনির্দেশনা প্রদান: এই বিভাগে ব্যাখ্যা করা হয়েছে কীভাবে বিভিন্ন স্থানের মধ্যে দিকনির্দেশনা প্রদানকারী ইউআরএল তৈরি করতে হয়, যার মধ্যে একাধিক ওয়েপয়েন্টসহ দিকনির্দেশনা এবং টার্ন-বাই-টার্ন নেভিগেশন অন্তর্ভুক্ত রয়েছে।

গুগল ম্যাপে স্থানের বিবরণ প্রদর্শন করা

স্থান অনুসন্ধান সম্পন্ন করার জন্য সার্চ ফাংশনটি দুটি প্যারামিটার গ্রহণ করে, যেগুলো হলো query (আবশ্যক) এবং query_place_id (ঐচ্ছিক)।

সকল অনুসন্ধান অনুরোধের জন্য query প্যারামিটারটি আবশ্যক। এটি একটি স্থানের নাম, অথবা কমা দ্বারা পৃথক করা অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ক, অথবা একটি সাধারণ অনুসন্ধান শব্দ গ্রহণ করে।

সার্চ ইউআরএল কাঠামো:

https://www.google.com/maps/search/?api=1&parameters

দৃশ্যকল্প ১: একটি অনন্য স্থানের নামের বিবরণ প্রদর্শন করা

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House

এই উদাহরণে, শুধুমাত্র স্থানের নাম উল্লেখ করা হয়েছে। এই URL-টি সিডনি অপেরা হাউসের বিস্তারিত পৃষ্ঠাটি খোলে।

স্থানের নাম অনুসন্ধান করুন এবং স্থানের বিবরণ প্রদর্শন করুন

এখন, এমন একটি জায়গার কথা ভাবুন যার নাম অদ্বিতীয় নয়। আপনি যখন শুধু এই অদ্বিতীয় নামটি দিয়ে অনুসন্ধান করবেন তখন কী হবে? পরবর্তী পরিস্থিতিটি দেখুন।

দৃশ্যকল্প ২: একটি অ-অনন্য স্থানের নামের জন্য স্থান অনুসন্ধান করুন

https://www.google.com/maps/search/?api=1&query=7-Eleven

যেহেতু স্থানের নামটি অনন্য নয়, তাই এই ইউআরএলটি ভিউপোর্টের মধ্যেই কাছাকাছি সেভেন-ইলেভেন স্টোরগুলোর একটি তালিকা খুলে দেয়। এরপর ব্যবহারকারীরা কোনো নির্দিষ্ট স্টোর বেছে নিয়ে তার বিস্তারিত তথ্য দেখতে পারেন।

গুগল ম্যাপস-এ স্থানের তালিকা পৃষ্ঠাটি খুলুন

অ-অনন্য নাম অনুসন্ধানের জন্য স্থান তালিকা পৃষ্ঠা

অবস্থানের তালিকা এড়িয়ে সরাসরি কোনো নির্দিষ্ট বিবরণ পৃষ্ঠায় যেতে, আপনি আরও সুনির্দিষ্ট একটি পদ্ধতি ব্যবহার করতে পারেন। পরবর্তী উদাহরণটি দেখুন।

দৃশ্যকল্প ৩: একটি অ-অনন্য স্থানের নামের জন্য স্থানের বিবরণ প্রদর্শন করা

সাধারণ স্থানের নাম নিয়ে কাজ করার সময়, শুধু নাম দিয়ে খুঁজলে প্রায়শই স্থানগুলোর একটি তালিকা পাওয়া যায়। কোনো নির্দিষ্ট বিস্তারিত পৃষ্ঠায় সরাসরি যাওয়ার জন্য, আপনি নিম্নলিখিত পদ্ধতিগুলোর মধ্যে একটি ব্যবহার করতে পারেন:

পদ্ধতি ১: স্থানের নাম এবং ঠিকানা ব্যবহার করে সুনির্দিষ্ট অনুসন্ধান

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

এই URL-এ, query প্যারামিটারটি স্থানের নাম ও ঠিকানা হিসেবে বিন্যস্ত করা হয়েছে। এটি অনুসন্ধানকে সীমিত করতে এবং সরাসরি উদ্দিষ্ট স্থানে লিঙ্ক করতে সাহায্য করে।

পদ্ধতি ২: স্থান আইডি ব্যবহার করে

প্লেস আইডি গুগল প্লেসেস ডেটাবেস এবং গুগল ম্যাপসে কোনো স্থানকে অনন্যভাবে শনাক্ত করে।

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

এখানে, ChIJGcmcg7ZC1moRAOacd3HoEwM হলো নির্দিষ্ট স্থানটির অনন্য প্লেস আইডি। query প্যারামিটারটি এখনও প্রয়োজন, তবে এটি কেবল তখনই ব্যবহৃত হবে যখন গুগল ম্যাপস প্লেস আইডিটি খুঁজে পাবে না।

দৃশ্যকল্প ৪: অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্কের পাশাপাশি স্থান আইডি ব্যবহার করে স্থানের বিবরণ প্রদর্শন

প্লেস আইডি ব্যবহার করলে গুগল ম্যাপস কোনো স্থানের বিস্তারিত তথ্য দেখাতে পারে।

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE

অক্ষাংশ ও দ্রাঘিমাংশের পাশাপাশি স্থান আইডি ব্যবহার করে স্থানের বিস্তারিত পৃষ্ঠা

বিনামূল্যে স্থান আইডি পুনরুদ্ধার

স্থান এপিআই টেক্সট অনুসন্ধান (শুধুমাত্র আইডি) অনুরোধ:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-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'

স্থান এপিআই টেক্সট সার্চ (শুধুমাত্র আইডি) এর প্রতিক্রিয়া:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

উপসংহার

একটি ইতিবাচক অভিজ্ঞতার জন্য স্থানের সঠিক বিবরণ প্রদান করা অত্যন্ত গুরুত্বপূর্ণ। ব্যবহারকারীরা যাতে সঠিক স্থানের বিবরণ পৃষ্ঠায় পৌঁছান, তা নিশ্চিত করতে নিম্নলিখিত প্রস্তাবিত ফর্ম্যাটগুলির মধ্যে একটি ব্যবহার করে সার্চ ইউআরএল (URL) তৈরি করুন:

query=PLACE_NAME, ADDRESS
query=PLACE_NAME&query_place_id=PLACE_ID

যখন আপনার লক্ষ্য কোনো নির্দিষ্ট স্থানের বিবরণ প্রদর্শন করা, তখন query প্যারামিটারে শুধুমাত্র অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করা থেকে বিরত থাকুন। query=latitude,longitude , query=PLACE_NAME,latitude,longitude , বা query=ADDRESS,latitude,longitude এর মতো ফরম্যাটগুলো ধারাবাহিকভাবে কাঙ্ক্ষিত স্থানের বিবরণ পৃষ্ঠায় নিয়ে যাবে না। এর পরিবর্তে, এটি অবস্থানটির অক্ষাংশ এবং দ্রাঘিমাংশ দেখাবে।

ম্যাপ ইউআরএল ব্যবহার করে বিভাগীয় অনুসন্ধান

ক্যাটাগরিক্যাল সার্চের ক্ষেত্রে, আপনি একটি সাধারণ সার্চ টার্ম দেন এবং গুগল ম্যাপস আপনার নির্দিষ্ট করা অবস্থানের কাছাকাছি আপনার শর্ত পূরণ করে এমন তালিকা খুঁজে বের করার চেষ্টা করে। যদি কোনো অবস্থান নির্দিষ্ট না করা হয়, গুগল ম্যাপস আপনার বর্তমান অবস্থানের কাছাকাছি তালিকা খুঁজে বের করার চেষ্টা করে।

দৃশ্যকল্প ১: কাছাকাছি স্থান অনুসন্ধান

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now

শ্রেণীভিত্তিক অনুসন্ধান - কাছাকাছি স্থান

Maps URL ব্যবহার করে দিকনির্দেশনা প্রদান

Directions ফাংশনটি ম্যাপে দুই বা ততোধিক নির্দিষ্ট বিন্দুর মধ্যবর্তী পথ, সেইসাথে দূরত্ব এবং ভ্রমণের সময় প্রদর্শন করে। এটি ডেভেলপারদের প্রদত্ত দিকনির্দেশনার উপর আরও বেশি নিয়ন্ত্রণ দেয়। GMP-এর Maps URLs Directions ডকুমেন্টেশনে কাস্টমাইজড দিকনির্দেশনার জন্য URL তৈরির বিষয়ে বিস্তারিত নির্দেশাবলী দেওয়া আছে।

দিকনির্দেশনা ইউআরএল কাঠামো:

https://www.google.com/maps/dir/?api=1&parameters

দৃশ্যকল্প ১: ব্যবহারকারীর বর্তমান অবস্থান থেকে গন্তব্যে পৌঁছানোর সেরা পথ খুঁজে বের করা।

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

এই ইউআরএলটি গুগল ম্যাপস খোলে এবং ব্যবহারকারীর বর্তমান অবস্থান থেকে গাড়ি চালিয়ে যাওয়ার দিকনির্দেশনা দেখায়।

এই URL-এ origin উল্লেখ করা নেই। origin উল্লেখ না করা হলে, পাথটি ডিফল্টভাবে সবচেয়ে প্রাসঙ্গিক শুরুর অবস্থান, যেমন ডিভাইসের অবস্থান (যদি উপলব্ধ থাকে), ব্যবহার করে। যদি কোনোটি উল্লেখ না থাকে, তবে ফলাফলস্বরূপ ম্যাপটিতে একটি ফর্ম দেওয়া থাকে, যার মাধ্যমে ব্যবহারকারী উৎস প্রবেশ করাতে পারেন। উৎস এবং গন্তব্যের মান কোনো স্থানের নাম, ঠিকানা, অথবা কমা দ্বারা পৃথক করা অক্ষাংশ/দ্রাঘিমাংশের স্থানাঙ্ক হতে পারে।

travelmode একটি ঐচ্ছিক প্যারামিটার। এটি ভ্রমণের উপায় নির্ধারণ করে। এই প্যারামিটারটি নিম্নোক্তভাবে সেট করা যেতে পারে:

গাড়ি চালানো
হাঁটা
সাইকেল চালানো
দুই চাকার যান
ট্রানজিট

যদি কোনো ভ্রমণ পদ্ধতি নির্দিষ্ট করা না থাকে, তাহলে গুগল ম্যাপ নির্দিষ্ট রুট এবং/অথবা ব্যবহারকারীর পছন্দের জন্য সবচেয়ে প্রাসঙ্গিক এক বা একাধিক পদ্ধতি প্রদর্শন করে।

ডেভেলপাররা origin_place_id প্যারামিটার এবং destination_place_id ব্যবহার করে প্লেস আইডি নির্দিষ্ট করতে পারেন। প্লেস আইডি ব্যবহার করাই হলো সঠিক স্থানে লিঙ্ক করার সর্বোত্তম নিশ্চয়তা।

বিনামূল্যে স্থান আইডি পুনরুদ্ধার

স্থান এপিআই টেক্সট অনুসন্ধান (শুধুমাত্র আইডি) অনুরোধ:

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-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'

স্থান এপিআই টেক্সট সার্চ (শুধুমাত্র আইডি) এর প্রতিক্রিয়া:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

ব্যবহারকারীর বর্তমান অবস্থান থেকে দিকনির্দেশনা

দৃশ্যকল্প ৩: ধাপে ধাপে দিকনির্দেশনা প্রদান

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

URL-এ dir_action=navigate সেট করলে, যদি ব্যবহারকারীর বর্তমান অবস্থান (ডিভাইসের অবস্থান) উপলব্ধ থাকে এবং উৎস হিসেবে ব্যবহৃত হয় (যা স্পষ্টভাবে প্রদান করা হতে পারে অথবা উৎস প্যারামিটারটি বাদ দিলে স্বয়ংক্রিয়ভাবে ব্যবহৃত হতে পারে), তাহলে Google Maps টার্ন-বাই-টার্ন নেভিগেশন মোডে চালু হবে। অন্যথায়, একটি রুট প্রিভিউ প্রদর্শিত হবে।

যখন dir_action=navigate সেট করা থাকে এবং নিম্নলিখিত শর্তগুলো পূরণ হয়, তখন টার্ন-বাই-টার্ন নেভিগেশন চালু হয়:

উৎসটি নির্দিষ্ট করা আছে এবং এটি ব্যবহারকারীর বর্তমান অবস্থানের কাছাকাছি।
উৎসটি বাদ দেওয়া হয়েছে এবং ব্যবহারকারীর বর্তমান অবস্থান উপলব্ধ।

রুট প্রিভিউ চালু হয় যখন:

dir_action=navigate সেট করা নেই
dir_action=navigate সেট করা আছে এবং অরিজিন নির্দিষ্ট করা আছে, কিন্তু অরিজিনটি ব্যবহারকারীর বর্তমান অবস্থানের কাছাকাছি নয়।
dir_action=navigate সেট করা আছে এবং অরিজিন বাদ দেওয়া হয়েছে, এবং ব্যবহারকারীর বর্তমান অবস্থান অনুপলব্ধ।

উল্লেখ্য যে, গুগল ম্যাপস ওয়েব-এর মতো গুগল ম্যাপসের সকল প্রোডাক্টে এবং/অথবা সকল গন্তব্যের মধ্যে নেভিগেশন উপলব্ধ নয়। সেইসব ক্ষেত্রে এই প্যারামিটারটি উপেক্ষা করা হবে।


ধাপে ধাপে দিকনির্দেশনা	রুট প্রিভিউ

উপসংহার

ম্যাপস ইউআরএলগুলো সঠিকভাবে তৈরি করার মাধ্যমে আপনি নিশ্চিত করতে পারেন যে ব্যবহারকারীরা তাদের প্রয়োজনীয় সঠিক তথ্য দ্রুত এবং দক্ষতার সাথে পাবে।

সর্বদা গন্তব্য নির্দিষ্ট করুন এবং নিশ্চিত নির্ভুলতার জন্য সম্ভব হলে স্থান আইডি (Place ID) ব্যবহার করুন।
তাৎক্ষণিক নেভিগেশন প্রদানের লক্ষ্যে, টার্ন-বাই-টার্ন নেভিগেশন চালু করতে dir_action=navigate প্যারামিটারটি অন্তর্ভুক্ত করুন। যদি ডিভাইসের অবস্থান উপলব্ধ থাকে এবং উৎস হিসেবে ব্যবহৃত হয় (যা স্পষ্টভাবে সেট করা বা বাদ দেওয়া হতে পারে), তাহলে নেভিগেশন ব্যবহারকারীর বর্তমান অবস্থান থেকে শুরু হবে।

আপনার অ্যাপ্লিকেশনের জন্য সঠিক পদ্ধতি নির্বাচন করা

আপনার কাছে দুটি প্রধান বিকল্প রয়েছে: প্লেসেস এপিআই (Places API) দ্বারা প্রদত্ত পূর্ব-ফরম্যাট করা ইউআরএল (URL) ব্যবহার করা অথবা আপনার অ্যাপ্লিকেশনে ম্যানুয়ালি ম্যাপস ইউআরএল (Maps URL) তৈরি করা। প্রতিটি পদ্ধতিরই নিজস্ব সুবিধা এবং অসুবিধা রয়েছে।

স্থান এপিআই:

Place Details রেসপন্সের googleMapsUri এবং googleMapsLinks ফিল্ডগুলো ব্যবহারের জন্য প্রস্তুত ইউআরএল প্রদান করে। এটি ডেভেলপমেন্টের সময় কমায় এবং ইউআরএল ফরম্যাটিং-এ ভুলের ঝুঁকি হ্রাস করে।
দিকনির্দেশনার কনফিগারেশনের উপর নিয়ন্ত্রণ কম থাকে। যদিও googleMapsLinks সাধারণ দিকনির্দেশনা দেয়, এটি ওয়েপয়েন্ট বা উন্নত কাস্টমাইজেশন সমর্থন করে না। এছাড়াও, সরাসরি টার্ন-বাই-টার্ন নেভিগেশন চালু করা তুলনামূলকভাবে কম সহজ।

মানচিত্রের ইউআরএল:

এটি আরও বেশি নমনীয়তা এবং নিয়ন্ত্রণ প্রদান করে। ডেভেলপাররা স্থানের বিবরণ প্রদর্শন করতে এবং দিকনির্দেশনার বিভিন্ন দিক কনফিগার করতে ইউআরএল তৈরি করতে পারেন, যার মধ্যে রয়েছে ওয়েপয়েন্ট যোগ করা, ভ্রমণ মোড নির্দিষ্ট করা এবং টার্ন-বাই-টার্ন নেভিগেশন শুরু করা।
ইউআরএল প্যারামিটার এবং এর গঠন সম্পর্কে গভীর ধারণা থাকা প্রয়োজন। সতর্কতার সাথে না করা হলে, হাতে তৈরি করলে ভুলের সম্ভাবনা বেড়ে যায়।

UTM প্যারামিটার ব্যবহার করে ম্যাপের URL উন্নত করা

ডেভেলপাররা কীভাবে ম্যাপস ইউআরএল ইন্টিগ্রেট করছেন তা গুগলকে আরও ভালোভাবে বুঝতে সাহায্য করতে এবং সর্বোত্তম পারফরম্যান্স নিশ্চিত করতে, আমরা আপনাকে আপনার ইউআরএল তৈরিতে ইউটিএম ট্র্যাকিং প্যারামিটার অন্তর্ভুক্ত করতে উৎসাহিত করি। utm_source এবং utm_campaign প্যারামিটার যোগ করার মাধ্যমে, আপনি মূল্যবান ডেটা সরবরাহ করেন যা আমাদের ব্যবহারের ধরণ বিশ্লেষণ করতে এবং ম্যাপস ইউআরএল প্রোডাক্টটিকে উন্নত করতে সাহায্য করে।

utm_source প্যারামিটারের জন্য আপনার অ্যাপ্লিকেশনের নামটি ব্যবহার করুন। utm_campaign প্যারামিটারটি ব্যবহারকারীর উদ্দিষ্ট কাজকে প্রতিফলিত করবে, যেমন 'location_sharing', 'place_details_search' বা 'directions_request'।

উদাহরণস্বরূপ, UTM প্যারামিটারসহ একটি URL দেখতে এইরকম হতে পারে:

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

এই মাপকাঠিগুলো ধারাবাহিকভাবে ব্যবহার করলে তা আমাদের উন্নতির ক্ষেত্রগুলো চিহ্নিত করতে, সমস্যাগুলো আরও কার্যকরভাবে সমাধান করতে এবং পরিশেষে সকল ব্যবহারকারীকে আরও ভালো অভিজ্ঞতা প্রদান করতে সাহায্য করে।

পরবর্তী পদক্ষেপ

আরও পড়ার জন্য পরামর্শ:

অবদানকারীরা

প্রধান লেখকগণ:

টেরেসা কিন | গুগল ম্যাপস প্ল্যাটফর্ম সলিউশনস ইঞ্জিনিয়ার