Maps Embed API কোনও জাভাস্ক্রিপ্ট ছাড়াই iframe src URL হিসেবে সেট করা HTTP অনুরোধের মাধ্যমে কোনও ওয়েব পেজে ইন্টার্যাক্টিভ ম্যাপ বা Street View প্যানোরামা দেখায়। এটি place, view, directions, streetview ও search ম্যাপ মোড সাপোর্ট করে।
Maps Embed API: মূল তথ্য
- প্রোডাক্ট: Maps Embed API
- এছাড়াও এই নামে পরিচিত: Google Maps Embed API, Maps Embed
- বিভাগ: Maps
- প্ল্যাটফর্ম: জাভাস্ক্রিপ্ট (ব্রাউজার)
- এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Maps Embed API এক নজরে
- আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। Street View মোড Street View কভারেজের উপর নির্ভর করে;
regionপ্যারামিটার Maps Platform কভারেজ বিবরণ পৃষ্ঠায় তালিকাভুক্ত অঞ্চল গ্রহণ করে। (কভারেজ সংক্রান্ত বিবরণ)
Maps Embed API: কখন ব্যবহার করবেন
Maps Embed API ব্যবহার করুন যখন:
- কোনও জাভাস্ক্রিপ্ট ছাড়াই শুধুমাত্র HTML iframe ব্যবহার করে কোনও ওয়েব পেজে আপনার একটি ইন্টার্যাক্টিভ ম্যাপ বা Street View প্যানোরামা প্রয়োজন।
- আপনাকে কোনও এম্বেড করা ম্যাপে কোনও জায়গার পিন, ম্যাপ ভিউ, বিভিন্ন পয়েন্টের মধ্যে দিকনির্দেশ বা কোনও এলাকার সার্চ ফলাফল দেখাতে হবে।
- আপনার এমন একটি এম্বেড করা ম্যাপ প্রয়োজন যার জন্য অনুরোধ পিছু কোনও চার্জ দিতে হবে না এবং QPS বা দৈনিক অনুরোধের কোনও সীমা থাকবে না (তবে API কী প্রয়োজন)।
এইসব ক্ষেত্রে Maps Embed API ব্যবহার করবেন না:
- আপনাকে নিজের কন্টেন্ট ও ছবি দিয়ে ওয়েব ম্যাপ কাস্টমাইজ করতে হবে। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
- আপনাকে iframe URL প্যারামিটারের বাইরে প্রোগ্রাম্যাটিক ফিচার সহ একটি এম্বেড করা ম্যাপ এক্সটেন্ড করতে হবে। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
Maps Embed API: সেট-আপ
- পরিষেবা চালু করতে:
maps-embed-backend.googleapis.com - যাচাইকরণ: API key
- শুরু করা: Maps Embed API সেট-আপ করুন
- রেফারেন্স: Maps Embed API রেফারেন্স
- দাম: Maps Embed API ব্যবহার ও বিলিং
Maps Embed API: সাধারণ ভুল
- সমস্যা: হোস্ট পৃষ্ঠা যদি
referrerমেটা ট্যাগকেno-referrerবাsame-origin-এ সেট করে, তাহলে ব্রাউজারRefererহেডার পাঠায় না এবং HTTP-রেফারার-সীমাবদ্ধ API কী এম্বেড করার অনুরোধ বাতিল করে দিতে পারে। সমাধান: iframe-এreferrerpolicy="strict-origin-when-cross-origin"যোগ করুন যাতে সাইটের ডোমেন Google-এ পাঠানো হয়। /maps/documentation/embed/embedding-map দেখুন। - সমস্যা: এম্বেড করা ম্যাপের কোনও ডাইমেনশন ২০০ পিক্সেলের কম হলে তা কাজ করে না। সমাধান: iframe-এর
widthএবংheightঅন্তত ২০০ পিক্সেল সেট করুন। /maps/documentation/embed/embedding-map দেখুন। - সমস্যা: ব্যবহার করার জন্য কোনও চার্জ না লাগলেও, বিলিং চালু না থাকলে, বিলিং পদ্ধতি সঠিক না হলে, নিজের সেট করা দৈনিক সীমা পেরিয়ে গেলে অথবা রেফারার-সীমাবদ্ধ কী ব্যবহার করার সময় অনুরোধে HTTP রেফারার না থাকলে, "শুধুমাত্র ডেভেলপমেন্টের উদ্দেশ্যে" ওয়াটারমার্ক সহ একটি অন্ধকার ম্যাপ দেখানো হয়। সমাধান: প্রোজেক্টে সঠিক পেমেন্ট পদ্ধতি ব্যবহার করে বিলিং চালু করুন, নিজের থেকে সেট করা দৈনিক কোটার সীমা বাড়ান বা সরান এবং রেফারার-সীমাবদ্ধ কী-এর জন্য রেফারার পাঠানো হয়েছে কিনা তা নিশ্চিত করুন (যেমন, iframe-এ
referrerpolicy="strict-origin-when-cross-origin"সহ)। /maps/documentation/embed/error-messages দেখুন। - সমস্যা: ভুল অনুরোধের (ভুল বা অনুপস্থিত প্যারামিটার এবং API কী ও কোটা সংক্রান্ত সমস্যা যেমন অনুপস্থিত বা ভুল কী, Maps Embed API চালু না থাকা বা কী সংক্রান্ত বিধিনিষেধ লঙ্ঘন করা) ক্ষেত্রে, ব্রাউজার কনসোলে শুধু HTTP 4xx স্ট্যাটাস কোড দেখানো হয়, কোনও বর্ণনামূলক মেসেজ দেখানো হয় না; ম্যাপের পরিবর্তে iframe-এর মধ্যে সমস্যার টেক্সট দেখানো হয়। সমাধান: iframe-এ সমস্যার টেক্সট এবং কনসোল স্ট্যাটাস কোড (প্যারামিটার সংক্রান্ত সমস্যার জন্য ৪০০, কী না থাকলে ৪০১, ভুল কী-এর জন্য ৪০৩) পড়ুন, তারপর প্যারামিটার ও কী সঠিক কিনা, Maps Embed API চালু আছে কিনা এবং কী সংক্রান্ত বিধিনিষেধের কারণে অনুরোধে কোনও সমস্যা হচ্ছে কিনা তা কনফার্ম করুন। /maps/documentation/embed/error-messages দেখুন।
Maps Embed API-এর সাহায্যে আপনি কী কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।