Maps Static API-তে সমস্যার মেসেজ

Maps Static API কোনও অনুরোধ সম্পূর্ণ করতে না পারলে সমস্যা বা সতর্কতা দেখায়। এই নির্দেশিকায় সমস্যার মেসেজ ব্যাখ্যা করা হয়েছে এবং সেগুলি সমাধান করার জন্য নির্দেশাবলী দেওয়া হয়েছে।

অননুমোদিত অনুরোধ

ভুল অনুরোধের ক্ষেত্রে, Maps Static API HTTP 4xx স্ট্যাটাস কোড এবং সমস্যা বর্ণনা করে এমন একটি মেসেজ রিটার্ন করে, যা নিম্নলিখিত তালিকায় দেখানো হয়েছে। নির্দিষ্ট সমস্যার বিবরণ পেতে API-এর মাধ্যমে রিটার্ন করা আসল সমস্যার কোড ও মেসেজ চেক করুন।

অনুরোধে ভুল প্যারামিটার আছে অথবা প্রয়োজনীয় প্যারামিটার নেই। যেমন, size প্যারামিটারটি প্রত্যাশিত সংখ্যাসূচক মানের মধ্যে নেই অথবা অনুরোধে এটি নেই।
400 BAD REQUEST
অনুরোধে অন্তর্ভুক্ত API কীটি ভুল।
403 FORBIDDEN

সমস্যার কারণে ম্যাপ দেখানো না গেলে

অনুরোধটি সঠিক হলেও, ম্যাপ দেখাতে বাধা দেয় এমন অন্য কোনও সমস্যা হলে, Maps Static API, ম্যাপের পরিবর্তে টেক্সট বা সমস্যার ছবি রিটার্ন করে। যেমন, অ্যাপ্লিকেশন তার ব্যবহারের সীমা ছাড়িয়ে গেলে সমস্যা হয়।

ম্যাপের পরিবর্তে সমস্যার ছবি দেখানো হয়েছে
ম্যাপের পরিবর্তে একটি সমস্যার ছবি দেখানো হয়েছে

আপনি API কী ছাড়াই Maps Static API ব্যবহার করলে অথবা আপনার অ্যাকাউন্টে বিলিং চালু করা না থাকলে, পৃষ্ঠায় ম্যাপের পরিবর্তে একটি সমস্যার ছবি দেখানো হবে এবং সমস্যার ধরন নির্দেশ করে একটি লিঙ্ক দেওয়া হবে। যেমন, "g.co/staticmaperror/key."

কীলেস এন্ট্রি সংক্রান্ত সমস্যা ও সমাধান
ব্যবহারের সীমা সংক্রান্ত সমস্যা: প্রদত্ত দৈনিক ম্যাপ লোড করার সীমা পেরিয়ে গেছে আপনি API key ছাড়াই Maps Static API ব্যবহার করছেন। এই সমস্যার সমাধান করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
  1. API key পান
  2. বিলিং চালু করুন
  3. আপনার URL সাইন করুন
ব্যবহারের সীমা সংক্রান্ত সমস্যা: অনুরোধ করা URL-এ ডিজিটাল স্বাক্ষর নেই আপনার অনুরোধে প্রয়োজনীয় ডিজিটাল স্বাক্ষর নেই। এই সমস্যার সমাধান করতে, আপনার URL-এ সই করুন।

সতর্কতা

কিছু সমস্যার ক্ষেত্রে, API একটি ম্যাপ রিটার্ন করে, কিন্তু ম্যাপে কিছু তথ্য নাও থাকতে পারে। এটি ঘটলে, আপনি নিম্নলিখিত শর্তাবলী ব্যবহার করে সতর্কতা শনাক্ত করতে পারবেন:

  • ম্যাপের উপরে হলুদ রঙের সমস্যার বার দেখা যাচ্ছে, যার মধ্যে "ম্যাপ সংক্রান্ত সমস্যা: g.co/staticmaperror" লেখা আছে।
  • API, X-Staticmap-API-Warning নামের HTTP হেডার ফর্ম্যাটে একটি সতর্কতা রিটার্ন করে।

যেমন, নিম্নলিখিত URL-এ markers প্যারামিটারে একটি অপ্রত্যাশিত ভ্যালু রয়েছে:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

API একটি ম্যাপ রিটার্ন করে, কিন্তু "ম্যাপ সংক্রান্ত সমস্যা: g.co/staticmaperror" টেক্সট সহ ইমেজের উপর একটি হলুদ রঙের সমস্যার বার সুপারইম্পোজ করে দেখায়:

ম্যাপে এই সমস্যাটি দেখা যায়: g.co/staticmaperror
হলুদ সতর্কতা বার সহ ম্যাপ

এছাড়াও, API নিম্নলিখিত HTTP হেডার রিটার্ন করে:

X-Staticmap-API-Warning:Error geocoding: marker 1

নিচের সারণীতে HTTP হেডার হিসেবে API যে সতর্কতা দেখাতে পারে তা বর্ণনা করা হয়েছে:

X-Staticmap-API-Warning হেডার অংশে সতর্কতা
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* অনুরোধ জিওকোড করার সময় কোনও সমস্যা হয়েছে। এই মেসেজের অনেকগুলি ধরন আছে, এটি নির্ভর করে কোন এলিমেন্টে জিওকোডিং ব্যর্থ হয়েছে তার উপর, যেমন center, marker, visible বা path এবং ব্যর্থ হওয়া এলিমেন্টের সংখ্যার উপর। এই সতর্কতার একটি উদাহরণ হল X-Staticmap-API-Warning:Error geocoding: marker 1, যা আগের উদাহরণে দেখানো হয়েছে।
Too many geocoded markers requested (max is 15). অনুরোধে মানুষের-পঠনযোগ্য ঠিকানা সহ অনুমোদিত সর্বাধিক মার্কারের সংখ্যার চেয়ে বেশি মার্কার উল্লেখ করা হয়েছে। সর্বাধিক ১৫টি। এই সীমা শুধুমাত্র মানুষের-পঠনযোগ্য ঠিকানা হিসেবে নির্দিষ্ট করা মার্কারের ক্ষেত্রে প্রযোজ্য যেটির জিওকোডিং প্রয়োজন। এটি অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট সহ নির্দিষ্ট করা মার্কারের ক্ষেত্রে প্রযোজ্য নয়।
Too many geocoded polyline vertices requested (max is 15). অনুরোধে মানুষের পড়ার মতো ঠিকানা সহ অনুমোদিত সর্বাধিক সংখ্যক পলিলাইনের চেয়ে বেশি উল্লেখ করা হয়েছে। সর্বাধিক ১৫টি। এই সীমা শুধুমাত্র মানুষের-পঠনযোগ্য ঠিকানা হিসেবে নির্দিষ্ট করা ভার্টেক্স সহ পলিলাইনের ক্ষেত্রে প্রযোজ্য যেগুলির জিওকোডিং প্রয়োজন। এটি অক্ষাংশ ও দ্রাঘিমাংশ কোঅর্ডিনেট সহ নির্দিষ্ট করা পলিলাইনের ক্ষেত্রে প্রযোজ্য নয়।

আপনি HTTP হেডার সংক্রান্ত সতর্কতা Chrome DevTools Console, Firefox Web Console অথবা আপনার ব্রাউজারে থাকা এই ধরনের অন্যান্য টুলে দেখতে পাবেন।