মানচিত্র স্ট্যাটিক API-এ ত্রুটি বার্তা, মানচিত্র স্ট্যাটিক API-এ ত্রুটি বার্তা৷

কিছু ভুল হলে মানচিত্র স্ট্যাটিক API একটি ত্রুটি বা সতর্কতা জারি করতে পারে। এই নির্দেশিকা প্রতিটি ত্রুটি বার্তা ব্যাখ্যা করে, এবং ত্রুটিগুলি সমাধানের জন্য আরও নির্দেশাবলী প্রদান করে৷

অবৈধ অনুরোধ

একটি অবৈধ অনুরোধের ক্ষেত্রে, মানচিত্র স্ট্যাটিক API একটি HTTP 4xx স্ট্যাটাস কোড এবং সমস্যা বর্ণনা করে একটি বার্তা প্রদান করে। নীচে যেমন ত্রুটি অবস্থার উদাহরণ আছে. দ্রষ্টব্য: এটি সম্ভাব্য ত্রুটিগুলির একটি সম্পূর্ণ তালিকা নয়৷ নির্দিষ্ট সমস্যার বিশদ বিবরণের জন্য অনুগ্রহ করে প্রকৃত ত্রুটি কোড এবং API দ্বারা প্রত্যাবর্তিত বার্তাটি পরীক্ষা করুন৷

ত্রুটি অবস্থার উদাহরণ	স্ট্যাটাস কোড
অনুরোধে একটি অবৈধ প্যারামিটার রয়েছে বা একটি প্রয়োজনীয় প্যারামিটার অনুপস্থিত রয়েছে৷ উদাহরণস্বরূপ, size প্যারামিটারটি সাংখ্যিক মানের প্রত্যাশিত সীমার মধ্যে নয়, বা অনুরোধ থেকে অনুপস্থিত।	400 BAD REQUEST
অনুরোধে অন্তর্ভুক্ত API কীটি অবৈধ৷	403 FORBIDDEN

ত্রুটি যা একটি মানচিত্র প্রদর্শন হতে বাধা দেয়

যদি অনুরোধটি বৈধ হয়, কিন্তু অন্য একটি ত্রুটি ঘটে যা মানচিত্রটিকে প্রদর্শিত হতে বাধা দেয়, তাহলে Maps Static API ত্রুটির উপর নির্ভর করে মানচিত্রের পরিবর্তে পাঠ্য বা একটি ত্রুটি চিত্র প্রদান করে। এই ধরনের ত্রুটি অবস্থার একটি উদাহরণ হল যখন অ্যাপ্লিকেশনটি তার ব্যবহারের সীমা অতিক্রম করে।

চিত্র: মানচিত্রের পরিবর্তে একটি ত্রুটি চিত্র প্রদর্শিত হয়েছে

API কী এবং বিলিং সম্পর্কিত ত্রুটি৷

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

চাবিহীন ত্রুটি এবং সমাধান
	আপনি একটি API কী ছাড়া মানচিত্র স্ট্যাটিক API ব্যবহার করছেন। সমাধান করতে, আপনাকে অবশ্যই: একটি API কী পান বিলিং সক্ষম করুন আপনার URL সাইন ইন করুন
	আপনার অনুরোধে একটি ডিজিটাল স্বাক্ষর অনুপস্থিত (প্রয়োজনীয়)। সমাধান করতে, আপনার URL সাইন ইন করুন

সতর্কতা

কিছু ত্রুটি অবস্থার জন্য, API একটি মানচিত্র ফেরত দেয় কিন্তু কিছু তথ্য মানচিত্র থেকে অনুপস্থিত হতে পারে। যখন এটি ঘটে, তখন আপনাকে সতর্কতা জানানোর জন্য দুটি শর্ত দেখা দেয়।

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

উদাহরণস্বরূপ, নিম্নলিখিত ইউআরএলটিতে 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" সহ চিত্রের উপরে একটি হলুদ ত্রুটি বার প্রদর্শন করে:

API এছাড়াও নিম্নলিখিত HTTP শিরোনাম প্রদান করে:

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

নিম্নলিখিত সারণী সতর্কতা বর্ণনা করে যে API HTTP শিরোনাম হিসাবে ইস্যু করতে পারে:

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

আপনি Chrome DevTools Console , Firefox Web Console , বা আপনার ব্রাউজারে অন্যান্য সমতুল্য সরঞ্জামগুলিতে HTTP হেডার সতর্কতাগুলি দেখতে পারেন৷

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