এই নির্দেশিকাটি দেখায় কীভাবে আপনার ওয়েব পেজে একটি ইন্টারেক্টিভ মানচিত্র যুক্ত করতে হয়।
ম্যাপস এমবেড এপিআই ইউআরএল তৈরি করুন
নিম্নলিখিতটি একটি উদাহরণ URL যা Maps Embed API লোড করে:
https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS
প্রতিস্থাপন করুন:
- MAP_MODE এ আপনার ম্যাপ মোড লিখুন।
- আপনার API কী দিয়ে YOUR_API_KEY । আরও তথ্যের জন্য, Get API key দেখুন।
- আপনার ম্যাপ মোডের জন্য প্রয়োজনীয় এবং ঐচ্ছিক প্যারামিটারসহ PARAMETERS ।
URL-টি একটি iframe-এ যোগ করুন
আপনার ওয়েব পেজে ম্যাপস এমবেড এপিআই (Maps Embed API) ব্যবহার করতে, আপনার তৈরি করা ইউআরএল (URL)-টিকে একটি আইফ্রেমের (iframe) src অ্যাট্রিবিউটের ভ্যালু হিসেবে সেট করুন। আইফ্রেমের height এবং width অ্যাট্রিবিউটের মাধ্যমে ম্যাপের আকার নিয়ন্ত্রণ করুন, উদাহরণস্বরূপ:
<iframe
width="450"
height="250"
frameborder="0" style="border:0"
referrerpolicy="no-referrer-when-downgrade"
src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
allowfullscreen>
</iframe>উপরের আইফ্রেম নমুনাটি অতিরিক্ত প্রোপার্টিগুলো ব্যবহার করে:
- ম্যাপের নির্দিষ্ট অংশকে পূর্ণ স্ক্রিনে দেখানোর জন্য
allowfullscreenপ্রপার্টি ব্যবহার করা হয়। - ম্যাপের চারপাশ থেকে স্ট্যান্ডার্ড আইফ্রেম বর্ডারটি সরানোর জন্য
frameborder="0"এবংstyle="border:0"প্রপার্টিগুলো ব্যবহার করুন। - `
referrerpolicy="no-referrer-when-downgrade"প্রপার্টিটি ব্রাউজারকে রিকোয়েস্টের সাথেRefererহেডার হিসেবে সম্পূর্ণ URL পাঠানোর অনুমতি দেয়, যাতে API কী-এর সীমাবদ্ধতাগুলো সঠিকভাবে কাজ করতে পারে।
আপনি আপনার নিজের ওয়েবসাইটের কাঠামো এবং নকশা অনুযায়ী আইফ্রেমের আকার পরিবর্তন করতে পারেন, কিন্তু আমরা দেখেছি যে দর্শকরা সাধারণত বড় আকারের মানচিত্রের সাথে ইন্টারঅ্যাক্ট করতে বেশি স্বাচ্ছন্দ্যবোধ করেন। উল্লেখ্য যে, উভয় দিকে ২০০ পিক্সেলের কম আকারের এমবেডেড মানচিত্র সমর্থিত নয়।
এপিআই কী সীমাবদ্ধতা
যদি হোস্টিং ওয়েবসাইটের referrer মেটা ট্যাগ no-referrer বা same-origin এ সেট করা থাকে, তাহলে ব্রাউজার গুগল-কে Referer হেডার পাঠাবে না। এর ফলে আপনার এপিআই কী রেস্ট্রিকশন অনুরোধগুলো প্রত্যাখ্যান করতে পারে। রেস্ট্রিকশনটি সঠিকভাবে কাজ করার জন্য, উপরের উদাহরণের মতো আইফ্রেমে একটি referrerpolicy প্রপার্টি যোগ করুন, যাতে গুগল-কে Referer হেডার পাঠানোর জন্য স্পষ্টভাবে অনুমতি দেওয়া যায়।
মানচিত্র মোড নির্বাচন করুন
আপনার অনুরোধ 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-এস্কেপ করা স্থানের নাম, ঠিকানা, প্লাস কোড, বা স্থানের আইডি । স্পেস এস্কেপ করার ক্ষেত্রে ম্যাপস এমবেড এপিআই + এবং %20 উভয়ই সমর্থন করে। উদাহরণস্বরূপ, "City Hall, New York, 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 ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মানের সাথে ম্যাপ করা থাকে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্ম কভারেজ বিবরণ দেখুন। |
view মোড
নিম্নলিখিত উদাহরণটি মানচিত্রের একটি স্যাটেলাইট ভিউ প্রদর্শন করতে view মোড এবং ঐচ্ছিক maptype প্যারামিটার ব্যবহার করে:
https://www.google.com/maps/embed/v1/view
?key=YOUR_API_KEY
¢er=-33.8569,151.2152
&zoom=18
&maptype=satelliteআপনি নিম্নলিখিত প্যারামিটারগুলো ব্যবহার করতে পারেন:
| প্যারামিটার | প্রকার | বর্ণনা | গৃহীত মান |
|---|---|---|---|
center | প্রয়োজনীয় | মানচিত্র দৃশ্যের কেন্দ্র নির্ধারণ করে। | কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশ গ্রহণ করে; উদাহরণস্বরূপ: 37.4218,-122.0840 । |
zoom | ঐচ্ছিক | মানচিত্রের প্রাথমিক জুম স্তর নির্ধারণ করে। | মান 0 (সমগ্র বিশ্ব) থেকে 21 (স্বতন্ত্র ভবন) পর্যন্ত। নির্বাচিত স্থানে উপলব্ধ মানচিত্রের তথ্যের উপর নির্ভর করে ঊর্ধ্বসীমা পরিবর্তিত হতে পারে। |
maptype | ঐচ্ছিক | লোড করার জন্য মানচিত্র টাইলসের ধরন নির্ধারণ করে। | roadmap (ডিফল্ট) অথবা satellite |
language | ঐচ্ছিক | UI এলিমেন্ট এবং ম্যাপ টাইলের লেবেল প্রদর্শনের জন্য ব্যবহৃত ভাষা নির্ধারণ করে। ডিফল্টরূপে, দর্শনার্থীরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটারটি শুধুমাত্র কিছু দেশের টাইলের জন্য সমর্থিত; অনুরোধ করা নির্দিষ্ট ভাষাটি যদি টাইল সেটের জন্য সমর্থিত না হয়, তাহলে সেই টাইলসেটের ডিফল্ট ভাষা ব্যবহার করা হবে। | |
region | ঐচ্ছিক | ভূ-রাজনৈতিক সংবেদনশীলতার ভিত্তিতে প্রদর্শনের জন্য উপযুক্ত সীমানা ও লেবেল নির্ধারণ করে। | এটি একটি দুই-অক্ষরের (সংখ্যাসূচক নয়) ইউনিকোড অঞ্চল সাবট্যাগ হিসেবে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে, যা পরিচিত ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মানের সাথে ম্যাপ করা থাকে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্ম কভারেজ বিবরণ দেখুন। |
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-এস্কেপ করা স্থানের নাম, ঠিকানা, প্লাস কোড, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক, বা স্থানের আইডি । স্পেস এস্কেপ করার ক্ষেত্রে ম্যাপস এমবেড এপিআই + এবং %20 উভয়ই সমর্থন করে। উদাহরণস্বরূপ, "City Hall, New York, NY"-কে City+Hall,New+York,NY , অথবা প্লাস কোড "849VCWC8+R9"-কে 849VCWC8%2BR9 তে রূপান্তর করুন। |
destination | প্রয়োজনীয় | দিকনির্দেশনার শেষ বিন্দু নির্ধারণ করে। | URL-এস্কেপ করা স্থানের নাম, ঠিকানা, প্লাস কোড, অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক, বা স্থানের আইডি । স্পেস এস্কেপ করার ক্ষেত্রে ম্যাপস এমবেড এপিআই + এবং %20 উভয়ই সমর্থন করে। উদাহরণস্বরূপ, "City Hall, New York, NY"-কে City+Hall,New+York,NY , অথবা প্লাস কোড "849VCWC8+R9"-কে 849VCWC8%2BR9 তে রূপান্তর করুন। |
waypoints | ঐচ্ছিক | উৎস এবং গন্তব্যের মধ্যে দিকনির্দেশনা পাঠানোর জন্য এক বা একাধিক মধ্যবর্তী স্থান নির্দিষ্ট করে। | স্থানের নাম, ঠিকানা, বা স্থানের আইডি । একাধিক ওয়েপয়েন্ট নির্দিষ্ট করতে, স্থানগুলোকে আলাদা করার জন্য পাইপ ক্যারেক্টার (|) ব্যবহার করুন (যেমন Berlin,Germany|Paris,France )। আপনি সর্বোচ্চ ২০টি ওয়েপয়েন্ট নির্দিষ্ট করতে পারবেন। |
mode | ঐচ্ছিক | ভ্রমণের পদ্ধতি নির্ধারণ করে। যদি কোনো মোড নির্দিষ্ট করা না থাকে, তাহলে ম্যাপস এমবেড এপিআই নির্দিষ্ট রুটের জন্য এক বা একাধিক সবচেয়ে প্রাসঙ্গিক মোড প্রদর্শন করবে। | 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 ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মানের সাথে ম্যাপ করা থাকে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্ম কভারেজ বিবরণ দেখুন। |
streetview মোড
ম্যাপস এমবেড এপিআই আপনাকে এর কভারেজ এলাকা জুড়ে নির্দিষ্ট স্থান থেকে স্ট্রিট ভিউ ছবিগুলোকে ইন্টারেক্টিভ প্যানোরামা হিসেবে প্রদর্শন করতে দেয়। ব্যবহারকারীদের দেওয়া ফটোস্ফিয়ার এবং স্ট্রিট ভিউ-এর বিশেষ সংগ্রহগুলোও উপলব্ধ রয়েছে।
প্রতিটি স্ট্রিট ভিউ প্যানোরামা একটি নির্দিষ্ট স্থান থেকে সম্পূর্ণ ৩৬০-ডিগ্রি দৃশ্য প্রদান করে। ছবিগুলোতে ৩৬০-ডিগ্রি আনুভূমিক দৃশ্য (চারপাশে সম্পূর্ণ) এবং ১৮০-ডিগ্রি উল্লম্ব দৃশ্য (সোজা উপর থেকে সোজা নিচ পর্যন্ত) থাকে। 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)। এপিআইটি এই অবস্থানের সবচেয়ে কাছে তোলা প্যানোরামাটি প্রদর্শন করে। যেহেতু স্ট্রিট ভিউ চিত্রাবলী পর্যায়ক্রমে রিফ্রেশ করা হয় এবং প্রতিবার ছবিগুলো সামান্য ভিন্ন অবস্থান থেকে তোলা হতে পারে, তাই চিত্রাবলী আপডেট হওয়ার সময় আপনার অবস্থানটি একটি ভিন্ন প্যানোরামায় চলে যেতে পারে।panoহলো একটি নির্দিষ্ট প্যানোরামা আইডি। আপনিpanoনির্দিষ্ট করলে একটিlocationও নির্দিষ্ট করতে পারেন। API প্যানোরামা আইডিটি খুঁজে না পেলেই কেবলlocationব্যবহৃত হয়।
নিম্নলিখিত URL প্যারামিটারগুলো ঐচ্ছিক:
| প্যারামিটার | প্রকার | বর্ণনা | গৃহীত মান |
|---|---|---|---|
heading | ঐচ্ছিক | এটি উত্তর দিক থেকে ঘড়ির কাঁটার দিকে ডিগ্রিতে ক্যামেরার দিক নির্দেশ করে। | মান -১৮০° থেকে ৩৬০° পর্যন্ত ডিগ্রিতে। |
pitch | ঐচ্ছিক | এটি ক্যামেরার কোণ, অর্থাৎ উপর বা নিচের দিক, নির্দিষ্ট করে। ধনাত্মক মান ক্যামেরাকে উপরের দিকে এবং ঋণাত্মক মান নিচের দিকে কোণ করে রাখবে। ছবিটি তোলার সময় ক্যামেরার অবস্থানের উপর ভিত্তি করে ডিফল্ট পিচ ০° সেট করা হয়। এই কারণে, ০° পিচ প্রায়শই অনুভূমিক হয়, তবে সবসময় নয়। উদাহরণস্বরূপ, পাহাড় থেকে তোলা একটি ছবির ডিফল্ট পিচ সম্ভবত অনুভূমিক হবে না। | মান -৯০° থেকে ৯০° পর্যন্ত ডিগ্রিতে। |
fov | ঐচ্ছিক | এটি ছবির আনুভূমিক দৃশ্যক্ষেত্র নির্ধারণ করে। এর ডিফল্ট মান ৯০°। একটি নির্দিষ্ট আকারের ভিউপোর্টের ক্ষেত্রে, এই দৃশ্যক্ষেত্রকে জুমের মাত্রা হিসেবে বিবেচনা করা যেতে পারে, যেখানে ছোট সংখ্যা উচ্চতর জুমের মাত্রা নির্দেশ করে। | মান ডিগ্রিতে, যার পরিসর ১০° - ১০০° |
center | ঐচ্ছিক | মানচিত্র দৃশ্যের কেন্দ্র নির্ধারণ করে। | কমা দিয়ে আলাদা করা অক্ষাংশ ও দ্রাঘিমাংশ গ্রহণ করে; উদাহরণস্বরূপ: 37.4218,-122.0840 । |
zoom | ঐচ্ছিক | মানচিত্রের প্রাথমিক জুম স্তর নির্ধারণ করে। | মান 0 (সমগ্র বিশ্ব) থেকে 21 (স্বতন্ত্র ভবন) পর্যন্ত। নির্বাচিত স্থানে উপলব্ধ মানচিত্রের তথ্যের উপর নির্ভর করে ঊর্ধ্বসীমা পরিবর্তিত হতে পারে। |
maptype | ঐচ্ছিক | লোড করার জন্য মানচিত্র টাইলসের ধরন নির্ধারণ করে। | roadmap (ডিফল্ট) অথবা satellite |
language | ঐচ্ছিক | UI এলিমেন্ট এবং ম্যাপ টাইলের লেবেল প্রদর্শনের জন্য ব্যবহৃত ভাষা নির্ধারণ করে। ডিফল্টরূপে, দর্শনার্থীরা তাদের নিজস্ব ভাষায় ম্যাপ দেখতে পাবেন। এই প্যারামিটারটি শুধুমাত্র কিছু দেশের টাইলের জন্য সমর্থিত; অনুরোধ করা নির্দিষ্ট ভাষাটি যদি টাইল সেটের জন্য সমর্থিত না হয়, তাহলে সেই টাইলসেটের ডিফল্ট ভাষা ব্যবহার করা হবে। | |
region | ঐচ্ছিক | ভূ-রাজনৈতিক সংবেদনশীলতার ভিত্তিতে প্রদর্শনের জন্য উপযুক্ত সীমানা ও লেবেল নির্ধারণ করে। | এটি একটি দুই-অক্ষরের (সংখ্যাসূচক নয়) ইউনিকোড অঞ্চল সাবট্যাগ হিসেবে নির্দিষ্ট করা অঞ্চল কোড গ্রহণ করে, যা পরিচিত ccTLD ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মানের সাথে ম্যাপ করা থাকে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্ম কভারেজ বিবরণ দেখুন। |
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 ("টপ-লেভেল ডোমেইন") দুই-অক্ষরের মানের সাথে ম্যাপ করা থাকে। সমর্থিত অঞ্চলগুলির জন্য গুগল ম্যাপস প্ল্যাটফর্ম কভারেজ বিবরণ দেখুন। |
আইডি প্যারামিটার স্থাপন করুন
Maps Embed API কোনো স্থানের নাম বা ঠিকানা দেওয়ার পরিবর্তে প্লেস আইডি ব্যবহার সমর্থন করে। কোনো স্থানকে অনন্যভাবে শনাক্ত করার জন্য প্লেস আইডি একটি নির্ভরযোগ্য উপায়। আরও তথ্যের জন্য, Google Places API ডকুমেন্টেশন দেখুন।
Maps Embed API নিম্নলিখিত URL প্যারামিটারগুলির জন্য স্থান আইডি গ্রহণ করে:
-
q -
origin -
destination -
waypoints
একটি প্লেস আইডি ব্যবহার করতে হলে, আপনাকে প্রথমে place_id: প্রিফিক্সটি যোগ করতে হবে। নিচের কোডটি একটি দিকনির্দেশনা অনুরোধের উৎস হিসেবে নিউ ইয়র্ক সিটি হল-কে নির্দিষ্ট করে: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8 ।
radiusপ্রদত্ত অক্ষাংশ এবং দ্রাঘিমাংশকে কেন্দ্র করে প্যানোরামা অনুসন্ধানের জন্য একটি ব্যাসার্ধ নির্ধারণ করে, যা মিটারে নির্দিষ্ট করা হয়। বৈধ মানগুলি হলো অঋণাত্মক পূর্ণসংখ্যা। ডিফল্ট মান হলো ৫০।sourceস্ট্রিট ভিউ অনুসন্ধানকে নির্বাচিত উৎসগুলিতে সীমাবদ্ধ করে। বৈধ মানগুলি হলো:-
defaultস্ট্রিট ভিউ-এর জন্য পূর্বনির্ধারিত উৎসগুলো ব্যবহৃত হয়; অনুসন্ধান কোনো নির্দিষ্ট উৎসের মধ্যে সীমাবদ্ধ নয়। -
outdoorঅনুসন্ধানকে শুধুমাত্র বাইরের সংগ্রহগুলিতে সীমাবদ্ধ করে। ভেতরের সংগ্রহগুলি অনুসন্ধানের ফলাফলে অন্তর্ভুক্ত করা হয় না। মনে রাখবেন যে নির্দিষ্ট অবস্থানের জন্য বাইরের প্যানোরামা নাও থাকতে পারে। আরও মনে রাখবেন যে, অনুসন্ধানটি শুধুমাত্র সেই প্যানোরামাগুলিই দেখায় যেগুলি ভেতরের নাকি বাইরের, তা নির্ধারণ করা সম্ভব। উদাহরণস্বরূপ, ফটোস্ফিয়ারগুলি দেখানো হয় না, কারণ সেগুলি ভেতরের নাকি বাইরের, তা অজানা।
-