শুরু করুন

ভূমিকা

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

Maps URL ব্যবহার করার জন্য আপনার Google API কী প্রয়োজন নেই।

ইউনিভার্সাল ক্রস-প্ল্যাটফর্ম সিনট্যাক্স

Android অ্যাপ, iOS অ্যাপ বা ওয়েবসাইটের ডেভেলপার হিসেবে, আপনি একটি সাধারণ URL তৈরি করতে পারবেন এবং এটি Google Maps খুলবে এবং অনুরোধ করা অ্যাকশন পারফর্ম করবে, ম্যাপ খোলার সময় যে প্ল্যাটফর্মই ব্যবহার করা হোক না কেন।

  • Android ডিভাইসে:
    • Android-এর জন্য Google Maps অ্যাপ ইনস্টল করা ও অ্যাক্টিভ থাকলে, URL-টি Maps অ্যাপে Google Maps লঞ্চ করে এবং অনুরোধ করা অ্যাকশনটি পারফর্ম করে।
    • Google Maps অ্যাপ ইনস্টল করা না থাকলে বা বন্ধ করা থাকলে, URL ব্রাউজারে Google Maps চালু করে এবং অনুরোধ করা অ্যাকশনটি করে।
  • iOS ডিভাইসে:
    • iOS-এর জন্য Google Maps অ্যাপ ইনস্টল করা থাকলে, URL Maps অ্যাপে Google Maps লঞ্চ করে এবং অনুরোধ করা অ্যাকশন পারফর্ম করে।
    • Google Maps অ্যাপ ইনস্টল করা না থাকলে, URL ব্রাউজারে Google Maps লঞ্চ করে এবং অনুরোধ করা অ্যাকশনটি সম্পন্ন করে।
  • অন্য যেকোনও ডিভাইসে, URL ব্রাউজারে Google Maps চালু করে এবং অনুরোধ করা অ্যাকশন পারফর্ম করে।

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

Google Maps লঞ্চ করা এবং নির্দিষ্ট অ্যাকশন পারফর্ম করা

Google Maps চালু করতে এবং বিকল্প হিসেবে কাজ করে এমন ফাংশনগুলির মধ্যে একটি পারফর্ম করতে, অনুরোধ করা অ্যাকশনের উপর নির্ভর করে নিম্নলিখিত ফর্মগুলির মধ্যে একটির URL স্কিম ব্যবহার করুন:

  • সার্চ — Google Map চালু করুন যা নির্দিষ্ট জায়গার জন্য পিন দেখায় অথবা সাধারণ সার্চ করে ফলাফল দেখানোর জন্য ম্যাপ চালু করুন:
    https://www.google.com/maps/search/?api=1&parameters
  • দিকনির্দেশ — দিকনির্দেশের জন্য অনুরোধ করুন এবং ফলাফল সহ Google Maps খুলুন:
    https://www.google.com/maps/dir/?api=1&parameters
  • ম্যাপ দেখানো — কোনও মার্কার বা দিকনির্দেশ ছাড়াই Google Maps চালু করুন:
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • একটি সংক্ষিপ্ত তালিকা তৈরি করুন — নির্দিষ্ট জায়গার তালিকা সহ Google Maps খুলুন:
    https://www.google.com/maps/@?api=1&map_action=shortlist&parameters
  • Street View প্যানোরামা দেখানো — ইন্ট্যার‍্যাক্টিভ প্যানোরামা ছবি লঞ্চ করা:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

গুরুত্বপূর্ণ: api=1 প্যারামিটারটি Maps URL-এর সেই ভার্সন শনাক্ত করে যার জন্য এই URL ব্যবহার করা হয়। প্রতিটি অনুরোধে এই প্যারামিটার প্রয়োজন। শুধুমাত্র ১ হল সঠিক ভ্যালু। URL-এ api=1 না থাকলে, সব প্যারামিটার উপেক্ষা করা হবে এবং ডিফল্ট Google Maps অ্যাপ লঞ্চ করা হবে, এটি ব্রাউজার বা Google Maps মোবাইল অ্যাপে হতে পারে, এটি ব্যবহৃত প্ল্যাটফর্মের উপর নির্ভর করে (যেমন, https://www.google.com/maps)।

সঠিক URL তৈরি করা

আপনাকে অবশ্যই URL সঠিকভাবে এনকোড করতে হবে।

যেমন, কিছু প্যারামিটার বিভাজক হিসেবে পাইপ অক্ষর (|) ব্যবহার করে, যা আপনাকে চূড়ান্ত URL-এ %7C হিসেবে এনকোড করতে হবে। অন্যান্য প্যারামিটার কমা দ্বারা আলাদা করা মান ব্যবহার করে, যেমন অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক বা শহর, রাজ্য। আপনাকে অবশ্যই কমা %2C হিসেবে এনকোড করতে হবে। %20 দিয়ে স্পেস এনকোড করুন অথবা প্লাস চিহ্ন (+) দিয়ে সেগুলি পাল্টে দিন।

এছাড়াও, প্রতিটি অনুরোধের জন্য URL-এ সর্বাধিক ২,০৪৮টি অক্ষর থাকতে পারে। আপনার URL তৈরি করার সময় এই সীমা সম্পর্কে সচেতন থাকুন।

ম্যাপ অ্যাকশন

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

সার্চ করুন

সার্চ অ্যাকশন, দৃশ্যমান ম্যাপ অঞ্চল জুড়ে সার্চের ফলাফল দেখায়। নির্দিষ্ট কোনও জায়গা সার্চ করলে, ফলাফল হিসেবে দেখানো ম্যাপে নির্দিষ্ট লোকেশনে একটি পিন প্লেস করা হয় এবং উপলভ্য জায়গার বিবরণ দেখানো হয়।

সার্চ URL তৈরি করা

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

প্যারামিটারগুলি

  • query (প্রয়োজনীয়): ম্যাপে হাইলাইট করার জন্য জায়গা(গুলি) নির্দিষ্ট করে। সব সার্চ অনুরোধের জন্য কোয়েরি প্যারামিটার প্রয়োজন।
    • জায়গার নাম, ঠিকানা অথবা কমা দিয়ে আলাদা করা অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট হিসেবে লোকেশন নির্দিষ্ট করুন। স্ট্রিং URL-এনকোড করা হতে হবে, তাই "সিটি হল, নিউ ইয়র্ক, NY"-এর মতো ঠিকানা City+Hall%2C+New+York%2C+NY-এ পরিবর্তন করতে হবে।
    • সাধারণ সার্চ করা শব্দকে URL-এনকোডেড স্ট্রিং হিসেবে নির্দিষ্ট করুন, যেমন grocery+stores বা restaurants+in+seattle+wa।
  • query_place_id (ঐচ্ছিক): প্লেস আইডি হল একটি টেক্সট শনাক্তকারী যা অনন্যভাবে কোনও জায়গা শনাক্ত করে। search অ্যাকশনের জন্য, আপনাকে অবশ্যই একটি query উল্লেখ করতে হবে, তবে আপনি একটি query_place_id-ও উল্লেখ করতে পারেন। আপনি দুটি প্যারামিটারই উল্লেখ করলে, Google Maps যদি জায়গার আইডি খুঁজে না পায়, তাহলে শুধুমাত্র query ব্যবহার করা হয়। আপনি যদি কোনও নির্দিষ্ট প্রতিষ্ঠানের সাথে নিশ্চিতভাবে লিঙ্ক করার চেষ্টা করেন, তাহলে প্লেস আইডি হল সবচেয়ে ভাল গ্যারান্টি যে আপনি সঠিক জায়গার সাথে লিঙ্ক করবেন। এছাড়াও, অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট ব্যবহার করে নির্দিষ্ট লোকেশন কোয়েরি করার সময় query_place_id জমা দেওয়ার সাজেশন দেওয়া হয়।

সার্চের উদাহরণ

লোকেশন সার্চ

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

উদাহরণ ১: "Lumen Field" জায়গার নাম সার্চ করলে নিম্নলিখিত ম্যাপ দেখা যায়:

https://www.google.com/maps/search/?api=1&query=lumen+field

Lumen Field-এর ম্যাপ

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

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

উদাহরণ ৩: অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক এবং প্লেস আইডি ব্যবহার করে Lumen Field সার্চ করলে নিম্নলিখিত ম্যাপটি পাওয়া যায়:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

উদাহরণ ৪: "Starbucks" জায়গার নাম সার্চ করলে নিম্নলিখিত ম্যাপ দেখা যায়:

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

Starbucks-এর জন্য সার্চ ফলাফল

উদাহরণ ৫: জায়গার নাম ও জায়গার আইডি ব্যবহার করে নির্দিষ্ট Starbucks সার্চ করলে নিম্নলিখিত ম্যাপ দেখা যায়:

https://www.google.com/maps/search/?api=1&query=starbucks&query_place_id=ChIJsU30zM1qkFQRbnOm1_LBoG0

আপনার লক্ষ্য যদি কোনও নির্দিষ্ট জায়গার বিবরণ দেখানো হয়, তাহলে নিম্নলিখিত সাজেস্ট করা ফর্ম্যাটের যেকোনও একটি ব্যবহার করে Search URL তৈরি করুন:

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

প্রোগ্র্যামাটিক পদ্ধতিতে প্লেস আইডি পেতে, আপনি Places API: টেক্সট সার্চ(শুধুমাত্র আইডি) ফিচার ব্যবহার করতে পারেন। এটি হল প্লেস আইডি পাওয়ার একটি বিনামূল্যের পদ্ধতি। Place ID ও Place API(New) অনুরোধ সম্পর্কে আরও জানুন।

এছাড়াও, কোনও ব্যবহারকারী ম্যাপে POI-তে ক্লিক বা ট্যাপ করলে, প্লেস আইডি পাওয়া যেতে পারে। ক্লিক করা যায় এমন POI আইকন সম্পর্কে আরও বিবরণ জানুন (JavaScript, Android, iOS)

ক্যাটাগরি অনুযায়ী সার্চ

ক্যাটাগরি অনুযায়ী সার্চে, আপনি একটি সাধারণ সার্চ কোয়েরি দেন এবং Google Maps আপনার নির্দিষ্ট করা লোকেশনের কাছাকাছি আপনার মানদণ্ড পূরণ করে এমন তালিকা খুঁজে বের করার চেষ্টা করে। কোনও লোকেশন নির্দিষ্ট করা না থাকলে, Google Maps আপনার বর্তমান লোকেশনের কাছাকাছি তালিকা খোঁজার চেষ্টা করে। আপনি যদি কোনও ক্যাটেগরি অনুযায়ী সার্চের জন্য লোকেশন দিতে চান, তাহলে সাধারণ সার্চ স্ট্রিংয়ে লোকেশন অন্তর্ভুক্ত করুন (যেমন, pizza+seattle+wa)।

এই উদাহরণে, ওয়াশিংটন স্টেটের সিয়াটলে পিৎজা রেস্তোরাঁ সার্চ করলে, নিম্নলিখিত ম্যাপ দেখানো হয়:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa

দিকনির্দেশ

দিকনির্দেশ অ্যাকশন ম্যাপে নির্দিষ্ট করা দুই বা তার বেশি পয়েন্টের মধ্যেকার পথ দেখায়, সেইসাথে দূরত্ব ও ভ্রমণের সময়ও দেখায়।

দিকনির্দেশ URL তৈরি করা

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

প্যারামিটারগুলি

  • origin: শুরুর স্থান নির্ধারণ করে যেখান থেকে দিকনির্দেশ দেখানো হবে। ডিফল্ট হিসেবে সবচেয়ে প্রাসঙ্গিক শুরুর লোকেশন, যেমন ডিভাইসের লোকেশন, যদি উপলভ্য থাকে। কিছু না থাকলে, ম্যাপে একটি ফাঁকা ফর্ম দেখানো হতে পারে যাতে ব্যবহারকারী যাত্রা শুরুর স্থান লিখতে পারেন। ভ্যালু হিসেবে জায়গার নাম, ঠিকানা অথবা কমা দিয়ে আলাদা করা অক্ষাংশ/দ্রাঘিমাংশের কোঅর্ডিনেট লেখা যেতে পারে। স্ট্রিং URL-এনকোড করা হতে হবে, তাই "City Hall, New York, NY"-এর মতো ঠিকানা City+Hall%2C+New+York%2C+NY-এ কনভার্ট করতে হবে।

    মনে রাখবেন: আপনার URL-এ origin_place_id উল্লেখ না করলে, এই প্যারামিটার ঐচ্ছিক। আপনি যদি কোনও origin_place_id নির্দিষ্ট করতে চান, তাহলে আপনাকে URL-এ অবশ্যই একটি origin যোগ করতে হবে।

  • origin_place_id (ঐচ্ছিক): প্লেস আইডি হল একটি টেক্সট শনাক্তকারী যা অনন্যভাবে কোনও জায়গা শনাক্ত করে। আপনি যদি কোনও প্রতিষ্ঠানকে নির্দিষ্টভাবে উল্লেখ করার চেষ্টা করেন, তাহলে প্লেস আইডি ব্যবহার করা হল আপনি যে সঠিক জায়গার সাথে লিঙ্ক করবেন তার সবচেয়ে ভালো গ্যারান্টি। যেসব URL এই প্যারামিটার ব্যবহার করে সেগুলিতে অবশ্যই origin থাকতে হবে।
  • destination: দিকনির্দেশের এন্ডপয়েন্ট নির্ধারণ করে। কোনওটি না থাকলে, ফলাফল হিসেবে পাওয়া ম্যাপে একটি ফাঁকা ফর্ম থাকতে পারে, যাতে ব্যবহারকারী গন্তব্য লিখতে পারেন। ভ্যালু হিসেবে কোনও জায়গার নাম, ঠিকানা অথবা কমা দিয়ে আলাদা করা অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট লিখতে পারেন। স্ট্রিংটি URL-এনকোড করা হতে হবে, তাই "সিটি হল, নিউ ইয়র্ক, NY"-এর মতো ঠিকানাটি City+Hall%2C+New+York%2C+NY-এ কনভার্ট করতে হবে।

    মনে রাখবেন: এই প্যারামিটারটি ঐচ্ছিক, যদি না আপনি নিজের URL-এ একটি destination_place_id নির্দিষ্ট করেন। আপনি যদি একটি destination_place_id নির্দিষ্ট করতে চান, তাহলে আপনাকে অবশ্যই URL-এ একটি destination অন্তর্ভুক্ত করতে হবে।

  • destination_place_id (ঐচ্ছিক): প্লেস আইডি হল একটি টেক্সচুয়াল শনাক্তকারী যা অনন্যভাবে কোনও জায়গাকে শনাক্ত করে। আপনি যদি কোনও প্রতিষ্ঠানকে নির্দিষ্টভাবে উল্লেখ করার চেষ্টা করেন, তাহলে প্লেস আইডি ব্যবহার করা হল আপনি যে সঠিক জায়গার সাথে লিঙ্ক করবেন তার সবচেয়ে ভালো গ্যারান্টি। এই প্যারামিটার ব্যবহার করা URL-এ অবশ্যই একটি destination থাকতে হবে।
  • travelmode (ঐচ্ছিক): ভ্রমণের পদ্ধতি নির্ধারণ করে। বিকল্পের তালিকা এখানে দেওয়া হল:
    • driving
    • walking: পথচারীদের রাস্তা ও ফুটপাথ পছন্দ করে, যেখানে উপলভ্য।
    • bicycling: বাইকের রাস্তা থাকলে, সেই রাস্তা দিয়ে রুট। "সাইকেল চালানো" বলতে মানুষের শক্তিতে চালিত ভ্রমণ মোডকে বোঝায়।
    • two-wheeler: উপলভ্য হলে, টু-হুইলারের জন্য পছন্দসই রাস্তার মাধ্যমে রুট। "মোটরসাইকেল" বলতে মোটরসাইকেলের মতো দুই চাকার মোটরচালিত গাড়িকে বোঝায়। আরও তথ্যের জন্য, মোটরসাইকেল কভারেজ দেখুন।
    • transit
    কোনও travelmode উল্লেখ করা না থাকলে, Google Map নির্দিষ্ট রুট এবং/অথবা ব্যবহারকারীর পছন্দ অনুযায়ী সবচেয়ে প্রাসঙ্গিক এক বা একাধিক মোড দেখায়।
  • dir_action=navigate (ঐচ্ছিক): সোর্স উপলভ্য আছে কিনা তার উপর ভিত্তি করে, নির্দিষ্ট গন্তব্যের জন্য টার্ন-বাই-টার্ন নেভিগেশন বা রুটের প্রিভিউ চালু করে। ব্যবহারকারী যদি কোনও উৎস নির্দিষ্ট করেন এবং সেটি ব্যবহারকারীর বর্তমান লোকেশনের কাছাকাছি না হয় অথবা ডিভাইসের বর্তমান লোকেশন উপলভ্য না থাকে, তাহলে ম্যাপে রুটের প্রিভিউ দেখানো হয়। ব্যবহারকারী যদি কোনও গন্তব্য উল্লেখ না করেন (এই ক্ষেত্রে গন্তব্য ডিফল্ট হিসেবে বর্তমান ডিভাইসের লোকেশন হবে) অথবা গন্তব্য ব্যবহারকারীর বর্তমান লোকেশন কাছাকাছি হলে, ম্যাপে টার্ন-বাই-টার্ন নেভিগেশন চালু হয়ে যাবে। মনে রাখবেন যে নেভিগেশন সব Google Maps প্রোডাক্টে এবং/অথবা সব গন্তব্যের মধ্যে উপলভ্য নয়; সেইসব ক্ষেত্রে এই প্যারামিটার উপেক্ষা করা হবে।
  • waypoints: origin ও destination-এর মধ্যে দিয়ে যাওয়ার জন্য এক বা একাধিক মধ্যবর্তী স্থান নির্দিষ্ট করে দিকনির্দেশ দেয়। পাইপ অক্ষর (|) ব্যবহার করে একাধিক ওয়েপয়েন্ট নির্দিষ্ট করা যেতে পারে (যেমন, Berlin,Germany|Paris,France)। যে প্ল্যাটফর্মে লিঙ্ক খোলা হয় তার উপর নির্ভর করে অনুমোদিত ওয়েপয়েন্টের সংখ্যা পরিবর্তিত হয়, মোবাইল ব্রাউজারে সর্বাধিক তিনটি ওয়েপয়েন্ট এবং অন্যথায় সর্বাধিক নয়টি ওয়েপয়েন্ট কাজ করে। URL-এ যেভাবে তালিকাভুক্ত করা হয়েছে সেই একই ক্রমে ম্যাপে ওয়েপয়েন্ট দেখানো হয়। প্রতিটি ওয়েপয়েন্ট কোনও জায়গার নাম, ঠিকানা বা কমা দিয়ে আলাদা করা অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট হতে পারে। স্ট্রিং URL-এনকোড করা হতে হবে, তাই "Berlin,Germany|Paris,France"-এর মতো ওয়েপয়েন্ট Berlin%2CGermany%7CParis%2CFrance-এ কনভার্ট করতে হবে।

    মনে রাখবেন:

    • সব Google Maps প্রোডাক্টে ওয়েপয়েন্ট কাজ করে না; সেইসব ক্ষেত্রে এই প্যারামিটার উপেক্ষা করা হবে।
    • আপনার URL-এ waypoint_place_ids উল্লেখ না করলে, এই প্যারামিটারটি ঐচ্ছিক। আপনি waypoint_place_ids নির্দিষ্ট করতে চাইলে, আপনাকে URL-এ waypoints অন্তর্ভুক্ত করতে হবে।
  • waypoint_place_ids (ঐচ্ছিক): প্লেস আইডি হল একটি টেক্সচুয়াল শনাক্তকারী যা অনন্যভাবে কোনও জায়গাকে শনাক্ত করে। Waypoint_place_ids আপনাকে জায়গা আইডির তালিকা প্রদান করার অনুমতি দেয় যাতে waypoints-এর তালিকার সাথে তা ম্যাচ করা যায়। ওয়েপয়েন্টের মতো একই ক্রমে প্লেস আইডি তালিকাভুক্ত করতে হবে এবং পাইপ অক্ষর "|" ( URL-এনকোড করা %7C হিসেবে) ব্যবহার করে আলাদা করতে হবে। আপনি যদি নির্দিষ্ট কিছু প্রতিষ্ঠান নিশ্চিতভাবে উল্লেখ করতে চান, তাহলে প্লেস আইডি হল সঠিক জায়গায় লিঙ্ক করার সেরা গ্যারান্টি। এই প্যারামিটার ব্যবহার করা URL-এ অবশ্যই waypoints থাকতে হবে।
  • avoid (ঐচ্ছিক): রুট দেখানোর সময় যেসব ফিচার এড়িয়ে যাওয়া উচিত তা সেট করে। এটি এই বিকল্পগুলির মধ্যে এক বা একাধিক বিকল্পে সেট করা যেতে পারে, যা কমা অক্ষর "," ( URL-এনকোড করা %2C হিসেবে) দ্বারা আলাদা করা হয়:
    • ferries
    • highways
    • tolls

দিকনির্দেশের উদাহরণ

নিম্নলিখিত URL, দিকনির্দেশ মোডে ম্যাপ চালু করে এবং ব্যবহারকারীকে শুরু ও গন্তব্যের জায়গা লেখার জন্য একটি ফর্ম প্রদান করে।

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

যেখান থেকে যাত্রা শুরু হচ্ছে, সেখান থেকে গন্তব্য পর্যন্ত ম্যাপ

নিচের উদাহরণে, ওয়াশিংটন স্টেটের সিয়াটলে অবস্থিত স্পেস নিডেল থেকে পাইক প্লেস মার্কেট পর্যন্ত সাইকেল চালানোর দিকনির্দেশ সহ একটি ম্যাপ লঞ্চ করা হয়েছে।

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

কলকাতার ম্যাপ

নিচের উদাহরণে Google-এর মুম্বই অফিস থেকে মুম্বই আন্তর্জাতিক বিমানবন্দরে টু-হুইলারের দিকনির্দেশ সহ একটি ম্যাপ লঞ্চ করা হয়েছে।

।

https://www.google.com/maps/dir/?api=1&origin=Google+Mumbai+India&destination=Mumbai+Airport&travelmode=two-wheeler

মুম্বাই আন্তর্জাতিক বিমানবন্দর গন্তব্যের ম্যাপ

নিচের উদাহরণে, অস্ট্রেলিয়ার সিডনিতে Google অফিস থেকে কুইন ভিক্টোরিয়া বিল্ডিং পর্যন্ত হাঁটার দিকনির্দেশ সহ ম্যাপ চালু করা হয়।

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking

Queen Victoria Building গন্তব্যের ম্যাপ

ম্যাপ দেখানো হচ্ছে

ম্যাপ অ্যাকশন এমন একটি ম্যাপ রিটার্ন করে যাতে কোনও মার্কার বা দিকনির্দেশ থাকে না।

ম্যাপ URL তৈরি করা হচ্ছে

https://www.google.com/maps/@?api=1&map_action=map&parameters

প্যারামিটারগুলি

  • map_action=map (প্রয়োজনীয়): ম্যাপ ভিউয়ের ধরন নির্দিষ্ট করে দেখায়। Maps ও Street View একই এন্ডপয়েন্ট শেয়ার করে। ম্যাপ যাতে দেখানো হয় তা নিশ্চিত করতে, map_action-কে map হিসেবে উল্লেখ করতে হবে।
  • center (ঐচ্ছিক): ম্যাপ উইন্ডোর কেন্দ্র নির্ধারণ করে, এবং কমা দ্বারা পৃথক করা মান হিসেবে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক গ্রহণ করে (যেমন, -33.8569,151.2152)।
  • zoom (ঐচ্ছিক): ম্যাপের প্রাথমিক জুম লেভেল সেট করে। স্বীকৃত মান হল ০ (পুরো পৃথিবী) থেকে ২১ (ব্যক্তিগত বিল্ডিং) পর্যন্ত পূর্ণ সংখ্যা। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর নির্ভর করে সর্বোচ্চ সীমা আলাদা আলাদা হতে পারে। ডিফল্ট হল ১৫।
  • basemap (ঐচ্ছিক): কোন ধরনের ম্যাপ দেখানো হবে তা নির্ধারণ করে। মান roadmap (ডিফল্ট), satellite অথবা terrain হতে পারে।
  • layer (ঐচ্ছিক): ম্যাপে দেখানোর জন্য অতিরিক্ত লেয়ারকে ডিফাইন করে, যদি থাকে। ভ্যালু নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: none (ডিফল্ট), transit, traffic অথবা bicycling।

ম্যাপের উদাহরণ

এই উদাহরণ URL ব্যবহারকারীর বর্তমান লোকেশনকে কেন্দ্র করে ডিফল্ট Google Map চালু করে।

https://www.google.com/maps/@?api=1&map_action=map

নিচের উদাহরণে নিউ সাউথ ওয়েলসের ক্যাটুમ્বাতে কেন্দ্র করে একটি ম্যাপ দেখানো হয়েছে, অস্ট্রেলিয়া (-33.712206,150.311941-এ) এবং ঐচ্ছিক zoom ও basemap প্যারামিটার সেট করা হয়েছে।

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain

Street View প্যানোরামা দেখানো

প্যানো অ্যাকশন আপনাকে Street View ছবি ইন্টার‍্যাক্টিভ প্যানোরামা হিসেবে দেখানোর জন্য ভিউয়ার লঞ্চ করতে দেয়। প্রতিটি Street View প্যানোরামা একটি লোকেশন থেকে সম্পূর্ণ ৩৬০-ডিগ্রি ভিউ প্রদান করে। ছবিতে ৩৬০ ডিগ্রি অনুভূমিক ভিউ (সম্পূর্ণ চারপাশ) এবং ১৮০ ডিগ্রি উল্লম্ব ভিউ (একদম উপর থেকে একদম নিচ পর্যন্ত) থাকে। প্যানো অ্যাকশন একটি ভিউয়ার চালু করে যা ফলাফল প্যানোরামাকে কেন্দ্রে একটি ক্যামেরা সহ একটি গোলক হিসাবে রেন্ডার করে। আপনি ক্যামেরা ম্যানিপুলেট করে ক্যামেরার জুম ও ওরিয়েন্টেশন নিয়ন্ত্রণ করতে পারবেন।

Google Street View তার কভারেজ এরিয়া জুড়ে নির্দিষ্ট লোকেশন থেকে প্যানোরামিক ভিউ প্রদান করে। ব্যবহারকারীর কন্ট্রিবিউট করা ফটোস্ফিয়ার এবং Street View-এর বিশেষ সংগ্রহ উপলভ্য আছে।

Street View URL তৈরি করা হচ্ছে

https://www.google.com/maps/@?api=1&map_action=pano&parameters

প্যারামিটারগুলি

  • map_action=pano (প্রয়োজনীয়): দেখানোর জন্য ভিউয়ের ধরন নির্দিষ্ট করে। Maps ও Street View একই এন্ডপয়েন্ট শেয়ার করে। প্যানোরামা যাতে দেখানো হয় তা নিশ্চিত করতে, action-কে অবশ্যই pano হিসেবে উল্লেখ করতে হবে।

এছাড়াও, নিম্নলিখিত URL প্যারামিটারগুলির মধ্যে একটি প্রয়োজন:

  • viewpoint: ভিউয়ার viewpoint লোকেশনের সবচেয়ে কাছাকাছি তোলা প্যানোরামা ছবি দেখায়, যা কমা-সেপারেটেড অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট (যেমন 46.414382,10.013988) হিসেবে উল্লেখ করা হয়। Street View ছবি নিয়মিত রিফ্রেশ করা হয় এবং প্রতিবার ছবি তোলার সময় সামান্য আলাদা পজিশন থেকে তোলা হতে পারে, তাই ছবি আপডেট করার সময় আপনার লোকেশন অন্য কোনও প্যানোরামায় স্ন্যাপ করতে পারে।
  • pano: দেখাতে হবে এমন ছবির নির্দিষ্ট প্যানোরামা আইডি । আপনি pano নির্দিষ্ট করলে, viewpoint-ও নির্দিষ্ট করতে পারবেন। Google Maps প্যানোরামা আইডি খুঁজে না পেলে তবেই viewpoint ব্যবহার করা হয়। pano উল্লেখ করা থাকলে কিন্তু সেটি খুঁজে পাওয়া না গেলে এবং a viewpoint উল্লেখ করা না থাকলে, কোনও প্যানোরামা ছবি দেখানো হয় না। পরিবর্তে, Google Maps ডিফল্ট মোডে খোলে এবং ব্যবহারকারীর বর্তমান লোকেশন কেন্দ্র করে একটি ম্যাপ দেখায়।

এই URL প্যারামিটারগুলি ঐচ্ছিক:

  • heading: উত্তর দিক থেকে ঘড়ির কাঁটার দিকে ডিগ্রিতে ক্যামেরার কম্পাস হেডিং নির্দেশ করে। গ্রহণযোগ্য ভ্যালু হল -১৮০ থেকে ৩৬০ ডিগ্রি। যদি বাদ দেওয়া হয়, তাহলে কোয়েরির ভিউপয়েন্ট (যদি নির্দিষ্ট করা থাকে) এবং ছবির আসল লোকেশনের উপর ভিত্তি করে একটি ডিফল্ট শিরোনাম বেছে নেওয়া হয়।
  • pitch: ক্যামেরার অ্যাঙ্গেল, উপরে বা নিচে, নির্দিষ্ট করে। পিচ -৯০ থেকে ৯০ ডিগ্রির মধ্যে নির্দিষ্ট করা হয়। পজিটিভ ভ্যালু ক্যামেরা উপরের দিকে অ্যাঙ্গেল করবে এবং নেগেটিভ ভ্যালু ক্যামেরা নিচের দিকে অ্যাঙ্গেল করবে। ছবি তোলার সময় ক্যামেরার পজিশনের উপর ভিত্তি করে ডিফল্ট পিচ ০ সেট করা হয়। এই কারণে, ০ পিচ প্রায়শই অনুভূমিক হয়, তবে সবসময় নয়। যেমন, পাহাড়ে তোলা কোনও ছবিতে ডিফল্ট পিচ অনুভূমিক নাও হতে পারে।
  • fov: ছবির অনুভূমিক ফিল্ড অফ ভিউ নির্ধারণ করে। ফিল্ড অফ ভিউ ডিগ্রিতে প্রকাশ করা হয়, যার রেঞ্জ ১০ - ১০০। ডিফল্ট হিসেবে এটি ৯০। নির্দিষ্ট সাইজের ভিউপোর্ট নিয়ে কাজ করার সময়, ফিল্ড অফ ভিউকে জুম লেভেল হিসেবে বিবেচনা করা হয়, যেখানে ছোট সংখ্যা বেশি জুম লেভেল নির্দেশ করে।

Street View-এর উদাহরণ

প্রথম দুটি উদাহরণে আইফেল টাওয়ারের প্যানোরামা দেখানো হয়েছে। প্রথম উদাহরণে লোকেশন হিসেবে শুধু viewpoint ব্যবহার করা হয়েছে এবং ঐচ্ছিক heading, pitch ও fov প্যারামিটার সেট করা হয়েছে। তুলনা করার জন্য, দ্বিতীয় উদাহরণে pano আইডি এবং প্রথম উদাহরণের মতো একই প্যারামিটার ব্যবহার করা হয়েছে। তৃতীয় উদাহরণে একটি ইন্ডোর প্যানোরামা ছবি দেখানো হয়েছে।

উদাহরণ ১: লোকেশন নির্দিষ্ট করতে শুধুমাত্র viewpoint ব্যবহার করা হয়েছে।

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

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

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

উদাহরণ ৩: প্যানোরামা আইডি দিয়ে নির্দিষ্ট করা, যুক্তরাজ্যের লন্ডনে অবস্থিত Sarastro রেস্তোরাঁর ভিতরের প্যানোরামা দেখায়।

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

প্যানোরামা আইডি খোঁজা

নির্দিষ্ট কোনও প্যানোরামা ছবির আইডি খুঁজে পেতে, আপনি একাধিক পদ্ধতি ব্যবহার করতে পারেন।

একটি বাছাই তালিকা তৈরি করুন

শর্টলিস্ট অ্যাকশন নির্দিষ্ট কিছু জায়গার তালিকা দেখায় এবং ব্যবহারকারীকে সেগুলি তার Google Maps প্রোফাইলে সেভ করতে, অন্যদের সাথে শেয়ার করতে অথবা প্রতিটি জায়গা আলাদাভাবে এক্সপ্লোর করতে দেয়।

বাছাই তালিকার URL তৈরি করা হচ্ছে

https://www.google.com/maps/@?api=1&map_action=shortlist&parameters

প্যারামিটারগুলি

  • map_action=shortlist (প্রয়োজনীয়): শর্টলিস্ট অ্যাকশন নির্দিষ্ট করে।
  • place_ids (প্রয়োজনীয়): বাছাই তালিকায় অন্তর্ভুক্ত করার জন্য জায়গা নির্ধারণ করে। এই প্যারামিটার কমা দ্বারা আলাদা করা ভ্যালু হিসেবে এক বা একাধিক জায়গার আইডি গ্রহণ করে। আপনি সর্বাধিক ২০টি প্লেস আইডি উল্লেখ করতে পারবেন।

বাছাই তালিকার উদাহরণ

নিম্নলিখিত উদাহরণে তিনটি নির্দিষ্ট জায়গা সহ একটি শর্টলিস্টের ম্যাপ লঞ্চ করা হয়।

https://www.google.com/maps/@?api=1&map_action=shortlist&place_ids=ChIJKxjxuaNqkFQR3CK6O1HNNqY,ChIJdWjwULVqkFQRh8ifgzporms,ChIJQ_oEiK1qkFQRg3bU4l3mmWs

আরও উদাহরণ

ওয়েপয়েন্ট ব্যবহার করে দিকনির্দেশের উদাহরণ

নিম্নলিখিত দিকনির্দেশের উদাহরণগুলি Google Maps চালু করে এবং প্যারিস, ফ্রান্স থেকে চেরবার্গ, ফ্রান্স পর্যন্ত গাড়ি চালানোর দিকনির্দেশ দেখায়, নিম্নলিখিত ওয়েপয়েন্টগুলির মাধ্যমে রুট করে:

শহর, দেশস্থানের নামজায়গার আইডি
১. ভার্সাই, ফ্রান্স প্যালেস অফ ভার্সাই ChIJdUyx15R95kcRj85ZX8H8OAU
২. শার্ত্রে, ফ্রান্স শার্ত্রে ক্যাথিড্রাল ChIJKzGHdEgM5EcR_OBTT3nQoEA
৩. ল্য মঁ, ফ্রান্স ক্যাথেড্রাল অফ সেন্ট জুলিয়ান অফ লে ম্যানস ChIJG2LvQNCI4kcRKXNoAsPi1Mc
৪. কঁ, ফ্রান্স ক্যান ক্যাসেল ChIJ06tnGbxCCkgRsfNjEQMwUsc

উদাহরণ হিসেবে দেওয়া URL-এ, ওয়েপয়েন্টগুলি বিভিন্ন উপায়ে সংজ্ঞায়িত করা হয়েছে যাতে আপনি ফলাফল ম্যাপে ওয়েপয়েন্টগুলির ডিসপ্লেতে পার্থক্য তুলনা করতে পারেন।

উদাহরণ ১: শহর, দেশ হিসেবে সংজ্ঞায়িত ওয়েপয়েন্ট:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

উদাহরণ ২: নির্দিষ্ট জায়গার নাম হিসেবে উল্লেখ করা ওয়েপয়েন্ট:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

উদাহরণ ৩: ওয়েপয়েন্টকে শহর, দেশ হিসেবে সংজ্ঞায়িত করা হয়েছে এবং প্রতিটি ওয়েপয়েন্টে waypoint_place_ids নির্দিষ্ট এস্ট্যাবলিশমেন্টের জন্য প্রদান করা হয়েছে:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

উদাহরণ ৪: ওয়েপয়েন্টকে শহর, দেশ হিসেবে সংজ্ঞায়িত করে, তবে আগের উদাহরণের তুলনায় অন্য ক্রমে ওয়েপয়েন্ট তালিকাভুক্ত করে। এটি দেখায় যে URL-এ যেভাবে তালিকাভুক্ত করা হয়েছে, ম্যাপে ওয়েপয়েন্টগুলি সেই ক্রমে দেখানো হয়েছে।

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

ম্যাপের উদাহরণ

নির্দিষ্ট basemap (স্যাটেলাইট) ও layer (ট্রানজিট) সহ ম্যাপ দেখায়।

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

Street View-এর উদাহরণ

pano আইডি হিসেবে FIFE ইমেজ কী ব্যবহার করে Street View প্যানোরামা দেখায়। মনে রাখবেন যে pano আইডির শুরুতে F: থাকে।

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55

UTM প্যারামিটার সহ Maps URL উন্নত করা

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

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=YOUR_APP_NAME&utm_campaign=place_details_search