ম্যাপটি এম্বেড করুন

আপনার ওয়েব পেজে কীভাবে ইন্টার‍্যাক্টিভ ম্যাপ এম্বেড করবেন তা এই নির্দেশিকা থেকে জানতে পারবেন।

Maps Embed API URL তৈরি করুন

Maps Embed API লোড করে এমন একটি URL-এর উদাহরণ নিচে দেওয়া হল:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

পরিবর্তন করুন:

  • আপনার ম্যাপ মোড-এর সাথে MAP_MODE।
  • আপনার API key দিয়ে YOUR_API_KEY। আরও তথ্যের জন্য, API কী পান দেখুন।
  • আপনার ম্যাপ মোডের জন্য প্রয়োজনীয় ও ঐচ্ছিক প্যারামিটার সহ PARAMETERS।

iframe-এ URL যোগ করুন

আপনার ওয়েব পেজে Maps Embed API ব্যবহার করতে, আপনার তৈরি করা URL-কে iframe-এর src অ্যাট্রিবিউটের ভ্যালু হিসেবে সেট করুন। iframe-এর height এবং width অ্যাট্রিবিউট ব্যবহার করে ম্যাপের সাইজ কন্ট্রোল করুন, যেমন:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="strict-origin-when-cross-origin"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

উপরের iframe স্যাম্পেল অতিরিক্ত প্রপার্টি ব্যবহার করে:

  • allowfullscreen প্রপার্টি ম্যাপের নির্দিষ্ট কিছু অংশকে ফুল স্ক্রিনে দেখানোর অনুমতি দেয়।
  • ম্যাপের চারপাশ থেকে স্ট্যান্ডার্ড iframe বর্ডার সরানোর জন্য frameborder="0" এবং style="border:0" প্রপার্টি।
  • referrerpolicy="strict-origin-when-cross-origin" প্রপার্টি নিশ্চিত করে যে ব্রাউজার আপনার ওয়েবসাইটের ডোমেনকে Referer হেডার হিসেবে Google-এ পাঠায়। এটি আপনার নির্দিষ্ট পৃষ্ঠার পাথ ব্যক্তিগত রাখার পাশাপাশি, অনুরোধ যাচাই করার জন্য API কী সংক্রান্ত বিধিনিষেধকে অনুমতি দেয়।

আপনার ওয়েবসাইটের গঠন ও ডিজাইন অনুযায়ী iframe-এর সাইজ ছোট বড় করতে পারবেন, তবে আমরা দেখেছি যে বড় ম্যাপের সাথে ইন্টার‍্যাক্ট করা দর্শকদের পক্ষে সাধারণত সহজ হয়। মনে রাখবেন যে এম্বেড করা ম্যাপের সাইজ কোনও ডাইমেনশনেই ২০০ পিক্সেলের কম হলে তা কাজ করে না।

রেফারারের তথ্য এবং API কী সংক্রান্ত বিধিনিষেধ

হোস্টিং ওয়েবসাইটে referrer মেটা ট্যাগ no-referrer বা same-origin-এ সেট করা থাকলে, ব্রাউজার Google-এ Referer হেডার পাঠাবে না। এর ফলে আপনার API কী সংক্রান্ত বিধিনিষেধ অনুরোধ বাতিল করতে পারে। বিধিনিষেধ যাতে সঠিকভাবে কাজ করে, তার জন্য iframe-এ একটি referrerpolicy প্রপার্টি যোগ করুন, যেমনটি উপরের উদাহরণে দেখানো হয়েছে, যাতে Google-এ Referer হেডার পাঠানোর অনুমতি স্পষ্টভাবে দেওয়া যায়।

  • strict-origin-when-cross-origin (প্রস্তাবিত): Google-এ শুধু আপনার বেস ডোমেন (যেমন, https://example.com/) পাঠায়। এটি আপনার নির্দিষ্ট পৃষ্ঠার পাথ গোপনীয় রাখে এবং একই সাথে API কী সংক্রান্ত বিধিনিষেধও কাজ করে।
  • no-referrer-when-downgrade (লিগ্যাসি): নির্দিষ্ট পৃষ্ঠার পাথ ও কোয়েরি প্যারামিটার সহ সম্পূর্ণ URL পাঠায় (যেমন, https://example.com/contact?user=123)।

Referrer-Policy হেডার সম্পর্কে আরও জানুন।

ম্যাপ মোড বেছে নিন

আপনার অনুরোধের URL-এ ব্যবহার করার জন্য আপনি নিম্নলিখিত ম্যাপ মোডগুলির মধ্যে একটি নির্দিষ্ট করতে পারেন:

  • place: কোনও নির্দিষ্ট জায়গা বা ঠিকানায় ম্যাপ পিন দেখায়, যেমন ল্যান্ডমার্ক, ব্যবসা, ভৌগোলিক বৈশিষ্ট্য বা শহর।
  • view: কোনও মার্কার বা দিকনির্দেশ ছাড়াই ম্যাপ দেখায়।
  • directions: ম্যাপে নির্দিষ্ট করা দুই বা তার বেশি পয়েন্টের মধ্যে পথ, দূরত্ব এবং ভ্রমণের সময় দেখায়।
  • streetview: নির্দিষ্ট লোকেশন থেকে ইন্টার‍্যাক্টিভ প্যানোরামিক ভিউ দেখায়।
  • search: ম্যাপের দৃশ্যমান অঞ্চল জুড়ে সার্চের ফলাফল দেখায়।

placeটি মোড

নিম্নলিখিত URL, place ম্যাপ মোড ব্যবহার করে আইফেল টাওয়ারে ম্যাপ মার্কার দেখায়:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

আপনি নিম্নলিখিত প্যারামিটার ব্যবহার করতে পারবেন:

প্যারামিটার ধরন বিবরণ গ্রহণযোগ্য মান
q আবশ্যক ম্যাপ মার্কার লোকেশন নির্ধারণ করে। URL-এস্কেপ করা জায়গার নাম, ঠিকানা, Plus Code বা প্লেস আইডি। স্পেস এড়িয়ে যাওয়ার সময় Maps Embed API + এবং %20 দুটিকেই সাপোর্ট করে। যেমন, "সিটি হল, নিউ ইয়র্ক, NY"কে City+Hall,New+York,NY-এ অথবা প্লাস কোড "849VCWC8+R9"কে 849VCWC8%2BR9-এ পরিবর্তন করুন।
center ঐচ্ছিক ম্যাপ ভিউয়ের কেন্দ্র নির্ধারণ করে। কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশের ভ্যালু গ্রহণ করে; যেমন: 37.4218,-122.0840।
zoom ঐচ্ছিক ম্যাপের প্রাথমিক জুম লেভেল সেট করে। 0 (পুরো পৃথিবী) থেকে 21 (ব্যক্তিগত বিল্ডিং) পর্যন্ত ভ্যালু। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর ভিত্তি করে সর্বোচ্চ সীমা আলাদা হতে পারে।
maptype ঐচ্ছিক লোড করার জন্য ম্যাপ টাইলসের ধরন নির্ধারণ করে। roadmap (ডিফল্ট) বা satellite
language ঐচ্ছিক UI এলিমেন্ট এবং ম্যাপ টাইলসে লেবেল দেখানোর জন্য কোন ভাষা ব্যবহার করা হবে তা নির্ধারণ করে। ডিফল্ট হিসেবে, দর্শকরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটার শুধুমাত্র কিছু দেশের টাইলসের জন্য কাজ করে; যদি অনুরোধ করা নির্দিষ্ট ভাষা টাইল সেটের জন্য কাজ না করে, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে।
region ঐচ্ছিক ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে, দেখানোর জন্য উপযুক্ত সীমানা এবং লেবেল সংজ্ঞায়িত করে। দুটি অক্ষর (সংখ্যা নয়) দিয়ে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে পরিচিত ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের ভ্যালুর সাথে ম্যাপ করা ইউনিকোড অঞ্চল সাবট্যাগ। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজ সংক্রান্ত বিবরণ দেখুন।

viewটি মোড

নিচের উদাহরণে view মোড এবং ঐচ্ছিক maptype প্যারামিটার ব্যবহার করে ম্যাপের স্যাটেলাইট ভিউ দেখানো হয়েছে:

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

আপনি নিম্নলিখিত প্যারামিটার ব্যবহার করতে পারবেন:

প্যারামিটার ধরন বিবরণ গ্রহণযোগ্য মান
center আবশ্যক ম্যাপ ভিউয়ের কেন্দ্র নির্ধারণ করে। কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশের ভ্যালু গ্রহণ করে; যেমন: 37.4218,-122.0840।
zoom ঐচ্ছিক ম্যাপের প্রাথমিক জুম লেভেল সেট করে। 0 (পুরো পৃথিবী) থেকে 21 (ব্যক্তিগত বিল্ডিং) পর্যন্ত ভ্যালু। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর ভিত্তি করে সর্বোচ্চ সীমা আলাদা হতে পারে।
maptype ঐচ্ছিক লোড করার জন্য ম্যাপ টাইলসের ধরন নির্ধারণ করে। roadmap (ডিফল্ট) বা satellite
language ঐচ্ছিক UI এলিমেন্ট এবং ম্যাপ টাইলসে লেবেল দেখানোর জন্য কোন ভাষা ব্যবহার করা হবে তা নির্ধারণ করে। ডিফল্ট হিসেবে, দর্শকরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটার শুধুমাত্র কিছু দেশের টাইলসের জন্য কাজ করে; যদি অনুরোধ করা নির্দিষ্ট ভাষা টাইল সেটের জন্য কাজ না করে, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে।
region ঐচ্ছিক ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে, দেখানোর জন্য উপযুক্ত সীমানা এবং লেবেল সংজ্ঞায়িত করে। দুটি অক্ষর (সংখ্যা নয়) দিয়ে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে পরিচিত ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের ভ্যালুর সাথে ম্যাপ করা ইউনিকোড অঞ্চল সাবট্যাগ। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজ সংক্রান্ত বিবরণ দেখুন।

directionsটি মোড

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

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

আপনি নিম্নলিখিত প্যারামিটার ব্যবহার করতে পারবেন:

প্যারামিটার ধরন বিবরণ গ্রহণযোগ্য মান
origin আবশ্যক দিকনির্দেশ দেখানোর জন্য শুরুর পয়েন্ট নির্ধারণ করে। URL-এস্কেপ করা জায়গার নাম, ঠিকানা, Plus Code, অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট অথবা প্লেস আইডি। স্পেস এড়িয়ে যাওয়ার সময় Maps Embed API + এবং %20 দুটিকেই সাপোর্ট করে। যেমন, "সিটি হল, নিউ ইয়র্ক, NY"কে City+Hall,New+York,NY-এ অথবা প্লাস কোড "849VCWC8+R9"কে 849VCWC8%2BR9-এ পরিবর্তন করুন।
destination আবশ্যক দিকনির্দেশের এন্ডপয়েন্ট নির্ধারণ করে। URL-এস্কেপ করা জায়গার নাম, ঠিকানা, Plus Code, অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট অথবা প্লেস আইডি। স্পেস এড়িয়ে যাওয়ার সময় Maps Embed API + এবং %20 দুটিকেই সাপোর্ট করে। যেমন, "সিটি হল, নিউ ইয়র্ক, NY"কে City+Hall,New+York,NY-এ অথবা প্লাস কোড "849VCWC8+R9"কে 849VCWC8%2BR9-এ পরিবর্তন করুন।
waypoints ঐচ্ছিক যাত্রা শুরুর স্থান ও গন্তব্যের মধ্যে রুট সংক্রান্ত দিকনির্দেশের জন্য এক বা একাধিক মধ্যবর্তী স্থান নির্দিষ্ট করে। জায়গার নাম, ঠিকানা বা প্লেস আইডি। একাধিক ওয়েপয়েন্ট নির্দিষ্ট করতে পাইপ অক্ষর (|) ব্যবহার করে জায়গাগুলি আলাদা করুন (যেমন Berlin,Germany|Paris,France)। আপনি সর্বাধিক ২০টি ওয়েপয়েন্ট নির্দিষ্ট করতে পারবেন।
mode ঐচ্ছিক ভ্রমণের পদ্ধতি নির্ধারণ করে। কোনও মোড নির্দিষ্ট করা না থাকলে, Maps Embed API নির্দিষ্ট রুটের জন্য এক বা একাধিক সবচেয়ে প্রাসঙ্গিক মোড দেখাবে। driving, walking (যা পথচারীদের জন্য রাস্তা ও ফুটপাথকে অগ্রাধিকার দেয়, যেখানে উপলভ্য), bicycling (যা সাইকেল চালানোর পথ ও অগ্রাধিকারপ্রাপ্ত রাস্তা ব্যবহার করে এমন রুটকে অগ্রাধিকার দেয়, যেখানে উপলভ্য), transit, অথবা flying।
avoid ঐচ্ছিক দিকনির্দেশে এড়িয়ে যেতে হবে এমন ফিচার নির্দিষ্ট করে। মনে রাখবেন যে এটি বিধিনিষেধযুক্ত ফিচার সহ রুট বাদ দেয় না; এটি আরও অনুকূল রুটের দিকে ফলাফলকে প্রভাবিত করে। tolls, ferries এবং/অথবা highways। পাইপ অক্ষর দিয়ে একাধিক ভ্যালু আলাদা করুন (যেমন, avoid=tolls|highways)।
units ঐচ্ছিক ফলাফলে দূরত্ব দেখানোর সময় পরিমাপের পদ্ধতি, মেট্রিক বা ইম্পিরিয়াল, নির্দিষ্ট করে। units নির্দিষ্ট করা না থাকলে, origin কোয়েরির দেশ কোন ইউনিট ব্যবহার করা হবে তা নির্ধারণ করে। metric বা imperial
center ঐচ্ছিক ম্যাপ ভিউয়ের কেন্দ্র নির্ধারণ করে। কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশের ভ্যালু গ্রহণ করে; যেমন: 37.4218,-122.0840।
zoom ঐচ্ছিক ম্যাপের প্রাথমিক জুম লেভেল সেট করে। 0 (পুরো পৃথিবী) থেকে 21 (ব্যক্তিগত বিল্ডিং) পর্যন্ত ভ্যালু। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর ভিত্তি করে সর্বোচ্চ সীমা আলাদা হতে পারে।
maptype ঐচ্ছিক লোড করার জন্য ম্যাপ টাইলসের ধরন নির্ধারণ করে। roadmap (ডিফল্ট) বা satellite
language ঐচ্ছিক UI এলিমেন্ট এবং ম্যাপ টাইলসে লেবেল দেখানোর জন্য কোন ভাষা ব্যবহার করা হবে তা নির্ধারণ করে। ডিফল্ট হিসেবে, দর্শকরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটার শুধুমাত্র কিছু দেশের টাইলসের জন্য কাজ করে; যদি অনুরোধ করা নির্দিষ্ট ভাষা টাইল সেটের জন্য কাজ না করে, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে।
region ঐচ্ছিক ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে, দেখানোর জন্য উপযুক্ত সীমানা এবং লেবেল সংজ্ঞায়িত করে। দুটি অক্ষর (সংখ্যা নয়) দিয়ে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে পরিচিত ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের ভ্যালুর সাথে ম্যাপ করা ইউনিকোড অঞ্চল সাবট্যাগ। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজ সংক্রান্ত বিবরণ দেখুন।

streetviewটি মোড

Maps Embed API আপনাকে Street View ছবিকে ইন্ট্যার‍্যাক্টিভ প্যানোরামা হিসেবে দেখাতে দেয়। এটি কভারেজ এরিয়া জুড়ে নির্দিষ্ট লোকেশন থেকে নেওয়া হয়। ব্যবহারকারীর কন্ট্রিবিউট করা Photospheres এবং Street View-এর বিশেষ সংগ্রহ উপলভ্য।

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

নিচের streetview মোড প্যানোরামা দেখুন:

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

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

  • location-এ অক্ষাংশ ও দ্রাঘিমাংশ কমা দিয়ে আলাদা করা মান (46.414382,10.013988) হিসেবে দিতে হয়। API এই লোকেশনের সবচেয়ে কাছাকাছি তোলা প্যানোরামা ফটো দেখায়। Street View ছবি নিয়মিত রিফ্রেশ করা হয় এবং প্রতিবার সামান্য আলাদা অবস্থান থেকে ফটো তোলা হতে পারে, তাই ছবি আপডেট করার সময় আপনার লোকেশন অন্য প্যানোরামাতে স্ন্যাপ করা হতে পারে।

  • pano হল একটি নির্দিষ্ট প্যানোরামা আইডি। আপনি যদি একটি pano নির্দিষ্ট করেন, তাহলে আপনি একটি locationও নির্দিষ্ট করতে পারেন। API যদি প্যানোরামা আইডি খুঁজে না পায়, তাহলেই শুধু location ব্যবহার করা হয়।

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

প্যারামিটার ধরন বিবরণ গ্রহণযোগ্য মান
heading ঐচ্ছিক উত্তর দিক থেকে ঘড়ির কাঁটার দিকে ডিগ্রিতে ক্যামেরার কম্পাস হেডিং নির্দেশ করে। -১৮০° থেকে ৩৬০° পর্যন্ত ডিগ্রিতে মান
pitch ঐচ্ছিক ক্যামেরার অ্যাঙ্গেল, উপরে বা নিচে, নির্দিষ্ট করে। পজিটিভ ভ্যালু ক্যামেরাকে উপরের দিকে অ্যাঙ্গেল করবে এবং নেগেটিভ ভ্যালু ক্যামেরাকে নিচের দিকে অ্যাঙ্গেল করবে। ছবি ক্যাপচার করার সময় ক্যামেরার পজিশনের উপর ভিত্তি করে ডিফল্ট পিচ 0° সেট করা হয়। এই কারণে, ০° পিচ প্রায়শই অনুভূমিক হয়, তবে সবসময় নয়। যেমন, পাহাড়ে তোলা কোনও ছবিতে ডিফল্ট পিচ অনুভূমিক নাও হতে পারে। -৯০° থেকে ৯০° পর্যন্ত ডিগ্রিতে মান
fov ঐচ্ছিক ছবির হরাইজন্টাল ফিল্ড অফ ভিউ নির্ধারণ করে। এটি ডিফল্ট হিসেবে ৯০° থাকে। নির্দিষ্ট সাইজের ভিউপোর্ট নিয়ে কাজ করার সময় ফিল্ড অফ ভিউকে জুম লেভেল হিসেবে বিবেচনা করা যেতে পারে, যেখানে ছোট সংখ্যা বেশি লেভেলের জুম নির্দেশ করে। ডিগ্রিতে মান, ১০° - ১০০° রেঞ্জের মধ্যে
center ঐচ্ছিক ম্যাপ ভিউয়ের কেন্দ্র নির্ধারণ করে। কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশের ভ্যালু গ্রহণ করে; যেমন: 37.4218,-122.0840।
zoom ঐচ্ছিক ম্যাপের প্রাথমিক জুম লেভেল সেট করে। 0 (পুরো পৃথিবী) থেকে 21 (ব্যক্তিগত বিল্ডিং) পর্যন্ত ভ্যালু। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর ভিত্তি করে সর্বোচ্চ সীমা আলাদা হতে পারে।
maptype ঐচ্ছিক লোড করার জন্য ম্যাপ টাইলসের ধরন নির্ধারণ করে। roadmap (ডিফল্ট) বা satellite
language ঐচ্ছিক UI এলিমেন্ট এবং ম্যাপ টাইলসে লেবেল দেখানোর জন্য কোন ভাষা ব্যবহার করা হবে তা নির্ধারণ করে। ডিফল্ট হিসেবে, দর্শকরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটার শুধুমাত্র কিছু দেশের টাইলসের জন্য কাজ করে; যদি অনুরোধ করা নির্দিষ্ট ভাষা টাইল সেটের জন্য কাজ না করে, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে।
region ঐচ্ছিক ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে, দেখানোর জন্য উপযুক্ত সীমানা এবং লেবেল সংজ্ঞায়িত করে। দুটি অক্ষর (সংখ্যা নয়) দিয়ে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে পরিচিত ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের ভ্যালুর সাথে ম্যাপ করা ইউনিকোড অঞ্চল সাবট্যাগ। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজ সংক্রান্ত বিবরণ দেখুন।

searchটি মোড

Search মোড, দৃশ্যমান ম্যাপ অঞ্চল জুড়ে সার্চের ফলাফল দেখায়। সার্চের জন্য লোকেশন নির্দিষ্ট করার সাজেশন দেওয়া হয়, হয় সার্চ করা শব্দে (record+stores+in+Seattle) লোকেশন অন্তর্ভুক্ত করে অথবা সার্চ বাউন্ড করার জন্য center এবং zoom প্যারামিটার অন্তর্ভুক্ত করে।

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

আপনি নিম্নলিখিত প্যারামিটার ব্যবহার করতে পারবেন:

প্যারামিটার ধরন বিবরণ গ্রহণযোগ্য মান
q আবশ্যক সার্চ করা শব্দকে সংজ্ঞায়িত করে। এতে ভৌগোলিক বিধিনিষেধ অন্তর্ভুক্ত থাকতে পারে, যেমন in+Seattle বা near+98033।
center ঐচ্ছিক ম্যাপ ভিউয়ের কেন্দ্র নির্ধারণ করে। কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশের ভ্যালু গ্রহণ করে; যেমন: 37.4218,-122.0840।
zoom ঐচ্ছিক ম্যাপের প্রাথমিক জুম লেভেল সেট করে। 0 (পুরো পৃথিবী) থেকে 21 (ব্যক্তিগত বিল্ডিং) পর্যন্ত ভ্যালু। বেছে নেওয়া লোকেশনে উপলভ্য ম্যাপ ডেটার উপর ভিত্তি করে সর্বোচ্চ সীমা আলাদা হতে পারে।
maptype ঐচ্ছিক লোড করার জন্য ম্যাপ টাইলসের ধরন নির্ধারণ করে। roadmap (ডিফল্ট) বা satellite
language ঐচ্ছিক UI এলিমেন্ট এবং ম্যাপ টাইলসে লেবেল দেখানোর জন্য কোন ভাষা ব্যবহার করা হবে তা নির্ধারণ করে। ডিফল্ট হিসেবে, দর্শকরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটার শুধুমাত্র কিছু দেশের টাইলসের জন্য কাজ করে; যদি অনুরোধ করা নির্দিষ্ট ভাষা টাইল সেটের জন্য কাজ না করে, তাহলে সেই টাইলসেটের জন্য ডিফল্ট ভাষা ব্যবহার করা হবে।
region ঐচ্ছিক ভূ-রাজনৈতিক সংবেদনশীলতার উপর ভিত্তি করে, দেখানোর জন্য উপযুক্ত সীমানা এবং লেবেল সংজ্ঞায়িত করে। দুটি অক্ষর (সংখ্যা নয়) দিয়ে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে পরিচিত ccTLD ("টপ-লেভেল ডোমেন") দুটি অক্ষরের ভ্যালুর সাথে ম্যাপ করা ইউনিকোড অঞ্চল সাবট্যাগ। কাজ করে এমন অঞ্চলের জন্য Google Maps Platform কভারেজ সংক্রান্ত বিবরণ দেখুন।

জায়গার আইডি প্যারামিটার

Maps Embed API-তে জায়গার নাম বা ঠিকানা দেওয়ার পরিবর্তে জায়গার আইডি ব্যবহার করা যায়। কোনও জায়গাকে অনন্যভাবে শনাক্ত করার জন্য প্লেস আইডি হল একটি নির্ভরযোগ্য উপায়। আরও তথ্যের জন্য, Places API (নতুন) ডকুমেন্টেশন দেখুন।

Maps Embed API নিম্নলিখিত URL প্যারামিটারের জন্য প্লেস আইডি গ্রহণ করে:

  • q
  • origin
  • destination
  • waypoints

কোনও প্লেস আইডি ব্যবহার করতে, আপনাকে প্রথমে প্রিফিক্স place_id: যোগ করতে হবে। নিম্নলিখিত কোডটি দিকনির্দেশের অনুরোধের জন্য নিউ ইয়র্ক সিটি হলকে উৎস হিসেবে নির্দিষ্ট করে: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8।

  • radius মিটারে নির্দিষ্ট করা ব্যাসার্ধ সেট করে, যার মধ্যে প্যানোরামা সার্চ করতে হবে, প্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশের উপর কেন্দ্র করে। সঠিক ভ্যালু হল অ-নেতিবাচক পূর্ণসংখ্যা। ৫০ হল ডিফল্ট মান।

  • source Street View সার্চকে বেছে নেওয়া সোর্সের মধ্যে সীমাবদ্ধ করে। সঠিক ভ্যালু হল:

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