Maps JavaScript API-এর মাধ্যমে যেসব সমস্যার মেসেজ দেখানো হতে পারে, এই পৃষ্ঠায় সেগুলি বর্ণনা করা হয়েছে। Maps JavaScript API, JavaScript কনসোলে সমস্যা ও সতর্কতা মেসেজ লেখে। এছাড়াও, কিছু নির্দিষ্ট সমস্যার কারণে ওয়াটারমার্ক সহ অন্ধকার ম্যাপ দেখানো হতে পারে।
API কী ও বিলিং সংক্রান্ত সমস্যা
সমস্যার সমাধান
কিছু পরিস্থিতিতে, একটি অন্ধকার ম্যাপ বা 'নেগেটিভ' Street View ছবি, "শুধুমাত্র ডেভেলপমেন্টের উদ্দেশ্যে" টেক্সট সহ ওয়াটারমার্ক করা, দেখানো হতে পারে। এই ধরনের আচরণ সাধারণত API কী বা বিলিং সংক্রান্ত সমস্যার ইঙ্গিত দেয়। Google Maps Platform প্রোডাক্ট ব্যবহার করতে হলে, আপনার অ্যাকাউন্টে বিলিং চালু থাকতে হবে এবং সমস্ত অনুরোধে একটি বৈধ API কী থাকতে হবে। সমস্যার মেসেজ খুঁজে পাওয়ার ব্যাপারে সাহায্য পেতে, আপনার ব্রাউজারে সমস্যা চেক করা সংক্রান্ত বিভাগ দেখুন।
নিচে উল্লেখ করা ফ্লো আপনাকে সমস্যার সমাধান করতে সাহায্য করবে।
ডেভেলপার ও সাইটের মালিকদের জন্য Maps JavaScript API-এর ত্রুটি কোড
নিচের সারণীতে Maps JavaScript API-এর মাধ্যমে ফেরত পাঠানো সম্ভাব্য সমস্যার কোডগুলি তালিকাভুক্ত করা হয়েছে। এর সাথে কারণের বিবরণ এবং কীভাবে আপনি সমস্যার সমাধান করতে পারবেন তাও দেওয়া হয়েছে। সমস্যার মেসেজ খুঁজে পাওয়ার ব্যাপারে সাহায্য পেতে, আপনার ব্রাউজারে সমস্যা চেক করা সংক্রান্ত বিভাগ দেখুন।
ম্যাপ লোড করার সময় হওয়া সমস্যা
Maps JavaScript API লোড করার সময় কোনও সমস্যা হলে, সমস্যার কোডের ব্যাখ্যা জানতে নিচের সারণী দেখুন।
| সমস্যার কোড | মেসেজ | বিবরণ |
|---|---|---|
NotLoadingAPIFromGoogleMapsError
|
Maps JavaScript API সরাসরি Google-এর সার্ভার থেকে ডাউনলোড করতে হবে। |
Maps JavaScript API লোড করে এমন স্ক্রিপ্ট এলিমেন্টটি আপনার পৃষ্ঠায় সঠিকভাবে অন্তর্ভুক্ত করা হচ্ছে না। API যাতে সঠিকভাবে কাজ করে, তার জন্য এটি সরাসরি https://maps.googleapis.com থেকে লোড করতে হবে। Maps JavaScript API লোড করা দেখুন। |
TOSViolationMapError
|
এই ওয়েবসাইটটি Google Maps API পরিষেবার শর্তাবলী লঙ্ঘন করেছে বলে মনে হচ্ছে। এই ওয়েবসাইটের জন্য Google Maps API বন্ধ করা হয়েছে। |
Google Maps Platform পরিষেবার শর্তাবলী মেনে না চলার কারণে আপনার অ্যাপ্লিকেশন ব্লক করা হয়েছে, এই বিষয়ে আপনাকে একাধিক ইমেল বিজ্ঞপ্তি পাঠানো হয়েছে। ব্লক করার বিরুদ্ধে আপিল করতে এবং আপনার প্রয়োগ পর্যালোচনা করতে, এই ফর্ম পূরণ করুন। আপনি কয়েক কর্মদিবসের মধ্যে ইমেলের মাধ্যমে উত্তর পাবেন। এই সমস্যার সমাধান করতে আপনার API key বা ক্লায়েন্ট আইডি ক্রেডেনশিয়াল ব্যবহার করুন। API কী ও ক্লায়েন্ট আইডি সংক্রান্ত নির্দেশিকা দেখুন। |
UnauthorizedURLForClientIdMapError
|
প্রদান করা Google Maps ক্লায়েন্ট আইডি ব্যবহার করার জন্য এই URL অনুমোদিত নয়। |
স্ক্রিপ্ট লোডে অন্তর্ভুক্ত ক্লায়েন্ট আইডিটি ভুল, এর মেয়াদ শেষ হয়ে গেছে অথবা Maps JavaScript API লোড করা বর্তমান অ্যাড্রেস অনুমোদিত URL-এর তালিকায় যোগ করা হয়নি। অনুমোদিত URL রেজিস্টার করা দেখুন। |
Maps JavaScript API-এর ত্রুটি কোড
Chrome JavaScript Console, Firefox Web Console বা আপনার ব্রাউজারে অন্য কোনও সমতুল্য টুলে কোনও ত্রুটি দেখতে পেলে, ত্রুটি কোডের ব্যাখ্যা খুঁজে পেতে নিচের সারণীটি দেখুন।
Maps JavaScript API সমস্যা ও সতর্কতা, দুটিই রিটার্ন করে। সমস্যাটি Maps JavaScript API লোড করার সময় হওয়া গুরুতর সমস্যাকে নির্দেশ করে। আপনার পৃষ্ঠা API সঠিকভাবে লোড করতে পারছে না, এবং API সেই পৃষ্ঠায় কাজ করবে না। Maps JavaScript API লোড করার সময় সতর্কতা হিসেবে একটি অতিরিক্ত মেসেজ দেখানো হয়। সতর্কতাটি কোনও সমস্যার সম্ভাব্য কারণ বর্ণনা করে অথবা আপনার কোডে সম্ভাব্য সমস্যা সম্পর্কে পরামর্শ দেয় যা Maps JavaScript API লোড করে। আপনি যদি কোনও সমস্যা ছাড়াই শুধুমাত্র সতর্কতা পান, তাহলে API সেই পৃষ্ঠায় সঠিকভাবে কাজ করবে। তবে, আমরা সাজেস্ট করি যে আপনি এই সম্ভাব্য সমস্যাগুলিও সমাধান করুন।
| ডেভেলপার এরর কোড | ধরন | বিবরণ |
|---|---|---|
ApiNotActivatedMapError
|
সমস্যা |
আপনার API প্রোজেক্টে Maps JavaScript API অ্যাক্টিভেট করা নেই। আপনাকে Google Cloud কনসোলের API-এর মধ্যে Maps JavaScript API চালু করতে হতে পারে। আপনার প্রোজেক্টের জন্য Maps JavaScript API চালু করতে, নিচের বোতামে ক্লিক করুন।
|
ApiTargetBlockedMapError
|
সমস্যা |
এই API কী এই পরিষেবা বা API ব্যবহার করার জন্য অনুমোদিত নয়। আপনার প্রয়োজনীয় সব API ও পরিষেবা, চালু থাকা API-এর তালিকায় সঠিকভাবে উল্লেখ করা আছে কিনা তা নিশ্চিত করতে, Google Cloud কনসোলে আপনার API কী-এর API সংক্রান্ত বিধিনিষেধ সেটিংস চেক করুন। Cloud Console-এ API কী দেখুন। আরও তথ্যের জন্য, API নিরাপত্তা সংক্রান্ত পেশাদার পদ্ধতি দেখুন। |
DeletedApiProjectMapError
|
সমস্যা |
Cloud Console থেকে আপনার API প্রোজেক্ট মুছে ফেলা হতে পারে। আপনি যে প্রোজেক্টের জন্য API কী তৈরি করেছেন সেটি চেক করুন, এটি জাভাস্ক্রিপ্ট API লোডারে অন্তর্ভুক্ত। আপনি নতুন API প্রোজেক্ট তৈরি করতে এবং Cloud কনসোলে নতুন কী পেতে পারেন। নতুন প্রোজেক্ট তৈরি করতে এবং প্রোজেক্টের জন্য API কী পেতে, নিচে দেওয়া বোতামে ক্লিক করুন।
|
ClientBillingNotEnabledMapError
|
সমস্যা |
আপনার প্রোজেক্টে বিলিং চালু করা নেই। এই ক্লায়েন্ট আইডির সাথে যুক্ত Google Cloud প্রোজেক্টে আপনাকে বিলিং চালু করতে হবে, এখান থেকে। |
BillingNotEnabledMapError
|
সমস্যা |
আপনি নিজের প্রোজেক্টে বিলিং চালু করেননি, তাই এই সমস্যা হচ্ছে। আপনাকে Google Cloud প্রোজেক্টে বিলিং চালু করতে হবে এখানে। |
ExpiredKeyMapError
|
সমস্যা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে অন্তর্ভুক্ত API কী-এর মেয়াদ শেষ হয়ে গেছে অথবা সিস্টেম সেটি শনাক্ত করতে পারছে না। নতুন API কী তৈরি করার পরে আপনি এই সমস্যা দেখতে পেতে পারেন, যদি আপনি সিস্টেমের দ্বারা শনাক্ত করার আগেই কী ব্যবহার করার চেষ্টা করেন। কয়েক মিনিট অপেক্ষা করে আবার চেষ্টা করুন অথবা আপনাকে Cloud কনসোলে নতুন API কী তৈরি করতে হতে পারে। API কী পেতে, নিচের বোতামে ক্লিক করুন।
|
InvalidAppCheckTokenMapError
|
সমস্যা |
প্রদান করা App Check টোকেনটি ভুল বা এটির মেয়াদ শেষ হয়ে গেছে। এই সমস্যা তখনই হতে পারে, যদি অ্যাপ চেক যাচাইকরণ ব্যবহার করা হয়। App Check যাচাইকরণ সংক্রান্ত নির্দেশিকা দেখুন। |
InvalidClientIdMapError
|
সমস্যা |
যাচাইকরণের নিরাপত্তা ও নির্ভরযোগ্যতা বাড়াতে, Maps Platform ক্লায়েন্ট আইডি ২৬ মে, ২০২৫ থেকে বন্ধ করে দেওয়া হয়েছে এবং ৩১ মে, ২০২৬-এর পর থেকে আর ব্যবহার করা যাবে না। ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার Google Maps API পরিষেবা ট্রাফিক যাচাই করতে আপনাকে অবশ্যই API Key ক্রেডেনশিয়াল ব্যবহার করতে হবে। আরও তথ্যের জন্য, ক্লায়েন্ট আইডি মাইগ্রেশন গাইড দেখুন। গাইডে দেওয়া ধাপগুলি অনুসরণ করে সাময়িকভাবে ক্লায়েন্ট আইডি ফিরিয়ে আনুন। |
InvalidKeyMapError
|
সমস্যা |
API লোড করা স্ক্রিপ্ট এলিমেন্টে অন্তর্ভুক্ত API key খুঁজে পাওয়া যায়নি। আপনি সঠিক API কী ব্যবহার করছেন কিনা তা ভালোভাবে দেখে নিন। আপনি Cloud Console-এ নতুন API কী তৈরি করতে পারবেন। API কী পেতে, নিচের বোতামে ক্লিক করুন।
|
MalformedCredentialsMapError
|
সমস্যা |
আপনার অ্যাপ্লিকেশন কাজ করে না এমন URI স্কিম ব্যবহার করে। অ্যাপ্লিকেশনটি RFC 3986-এ সংজ্ঞায়িত সঠিক URI ফর্ম্যাট ব্যবহার করছে কিনা তা যাচাই করুন। |
MissingKeyMapError
|
সমস্যা |
এপিআই লোড করে এমন স্ক্রিপ্ট এলিমেন্টে প্রয়োজনীয় যাচাইকরণ প্যারামিটার নেই। আপনি Maps JavaScript API ব্যবহার করলে, আপনাকে অবশ্যই
সঠিক API key সহ আপনি ক্লায়েন্ট আইডি ব্যবহার করলে, আপনাকে অবশ্যই
ক্লায়েন্ট আইডির সাথে আপনি যদি ওয়েবসাইটের মালিক না হন, তাহলে এই সমস্যা সমাধানের জন্য আপনি কোনও পদক্ষেপ নিতে পারবেন না । তবে, সম্ভব হলে সাইটের মালিককে জানানো ভাল। |
ProjectDeniedMapError
|
সমস্যা |
আপনার অনুরোধ সম্পূর্ণ করা যায়নি। আপনি হয়ত Cloud কনসোলে সমস্যা সম্পর্কে আরও বিবরণ খুঁজে পেতে পারেন। Cloud কনসোল দেখুন। |
RefererDeniedMapError
|
সমস্যা |
Google Maps Platform পরিষেবার শর্তাবলী মেনে না চলার কারণে আপনার অ্যাপ্লিকেশন ব্লক করা হয়েছে, এই বিষয়ে আপনাকে একাধিক ইমেল বিজ্ঞপ্তি পাঠানো হয়েছে। ব্লক করার বিরুদ্ধে আপিল করতে এবং আপনার প্রয়োগ পর্যালোচনা করতে, এই ফর্ম পূরণ করুন। আপনি কয়েক কর্মদিবসের মধ্যে ইমেলের মাধ্যমে উত্তর পাবেন। |
RefererNotAllowedMapError
|
সমস্যা |
Maps JavaScript API লোড করা বর্তমান URL অনুমোদিত রেফারারের তালিকায় যোগ করা হয়নি। Cloud Console-এ আপনার API কী-এর রেফারের সেটিংস চেক করুন। Maps JavaScript API দেখুন এবং API কী পান। |
OverQuotaMapError
|
সমস্যা |
Maps JavaScript API-এর জন্য অনুরোধের সংখ্যা ব্যবহারের সীমা ছাড়িয়ে গেছে। পরের বার দৈনিক কোটা রিসেট করা হলে, আপনার অ্যাপের অনুরোধ আবার কাজ করবে। আপনি যদি ওয়েবসাইটের মালিক না হন, তাহলে এই সমস্যা সমাধানের জন্য আপনি কোনও পদক্ষেপ নিতে পারবেন না। তবে, সম্ভব হলে সাইটের মালিককে বিজ্ঞপ্তি পাঠাতে পারেন। আরও জানতে, ব্যবহারের সীমা সংক্রান্ত নির্দেশিকা দেখুন। এছাড়াও, আপনি কীভাবে আরও বেশি ব্যবহারের সীমা পেতে পারেন তা এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে। |
ApiProjectMapError
|
সমস্যা |
প্রদান করা API কী অথবা যে API প্রোজেক্টের সাথে এটি যুক্ত, সেটি সমাধান করা যায়নি। এই সমস্যাটি সাময়িক হতে পারে। এই সমস্যার মেসেজ দেখা যেতে থাকলে, আপনাকে হয়ত নতুন API কী পেতে হবে অথবা নতুন API প্রোজেক্ট তৈরি করতে হবে। আরও তথ্যের জন্য, Google Maps Platform ব্যবহার করা শুরু করুন দেখুন। |
ClientIdLooksLikeCryptoKey
|
সতর্কতা |
আপনি হয়ত ক্লায়েন্ট আইডি সংক্রান্ত গাইড দেখুন। |
ClientIdLooksLikeKey
|
সতর্কতা |
আপনি হয়ত API কী ও ক্লায়েন্ট আইডি সংক্রান্ত নির্দেশিকা দেখুন। |
InvalidChannel
|
সতর্কতা |
আপনি হয়ত ভুল |
InvalidClientId
|
সতর্কতা |
API কী ও ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
InvalidKey
|
সতর্কতা |
API লোড করা স্ক্রিপ্ট এলিমেন্টে থাকা API key সঠিক মনে হচ্ছে না। আপনি সঠিক API key ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনি Cloud Console-এ নতুন API কী তৈরি করতে পারবেন। API key পেতে, নিচের বোতামে ক্লিক করুন।
|
InvalidVersion
|
সতর্কতা |
আপনার স্ক্রিপ্ট এলিমেন্টে ভুল ভার্সন নম্বর দেওয়া হতে পারে। আপনি সঠিক ভার্সন নম্বর ব্যবহার করছেন কিনা তা ভালোভাবে দেখে নিন। |
KeyLooksLikeClientId
|
সতর্কতা |
আপনি হয়ত API কী ও ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
KeyLooksLikeCryptoKey
|
সতর্কতা |
আপনি হয়ত API লোড করার সময় ক্লায়েন্ট আইডি নির্দিষ্ট করা সংক্রান্ত নির্দেশিকা দেখুন। |
KeyLooksLikeProjectNumber
|
সতর্কতা |
আপনি হয়ত API 'কী' কীভাবে পাবেন তা জানুন। |
NoApiKeys
|
সতর্কতা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে কোনও API key নেই। আপনি
API কী পেতে, শুরু করতে নিচের বোতামে ক্লিক করুন।
আপনি যদি বন্ধ হয়ে যাওয়া v2 পাথ থেকে Maps JavaScript API লোড করেন, তাহলে আপনি |
RetiredVersion
|
সতর্কতা |
আপনার স্ক্রিপ্ট এলিমেন্টে হয়ত বন্ধ হয়ে যাওয়া ভার্সন দিয়েছেন। উপলভ্য ভার্সনগুলির মধ্যে একটি ব্যবহার করতে, আপনার অ্যাপ্লিকেশন আপডেট করুন। |
SensorNotRequired
|
সতর্কতা |
Maps JavaScript API-এর জন্য |
SignatureNotRequired
|
সতর্কতা |
Maps JavaScript API-এর জন্য |
SignedInNotSupported
|
সতর্কতা |
|
UrlAuthenticationCommonError
|
সমস্যা |
এমন একটি সমস্যা হয়েছে যা এই পৃষ্ঠার অন্যান্য বিভাগের সাথে মানানসই নয়। এটি সাময়িক সমস্যার কারণে হতে পারে। কিছুক্ষণ পরে আবার অনুরোধ করার চেষ্টা করুন। এর পরেও সমস্যার সমাধান না হলে, অনুরোধটি সঠিক ফর্ম্যাটে আছে কিনা তা নিশ্চিত করতে ডেভেলপার গাইড ভাল করে পড়ে দেখুন। |
আপনার ব্রাউজারে সমস্যা চেক করা হচ্ছে
Maps JavaScript API,
window.console-এ সমস্যার মেসেজ লেখে। এই বিভাগে ব্যাখ্যা করা হয়েছে যে আপনি কীভাবে Google Chrome-এ
window.console আউটপুট চেক করতে পারবেন। আপনি অন্য কোনও ব্রাউজার ব্যবহার করলে, আপনার ব্রাউজারের জন্য ডেভেলপার ডকুমেন্টেশন চেক করুন। আপনার রেফারেন্সের জন্য, অন্যান্য কিছু ব্রাউজারে window.console আউটপুট চেক করার জন্য
টুলের তালিকা এখানে দেওয়া হল।
- Firefox-এর জন্য ওয়েব কনসোল।
- Android-এর জন্য রিমোট ডিবাগিং।
- iOS-এর জন্য Web Inspector।
Chrome-এ, আপনি
JavaScript Console
ব্যবহার করে নিচে উল্লেখ করা পদ্ধতি অনুযায়ী window.console আউটপুট চেক করতে পারবেন।
- ডেভেলপার টুল খুলতে, মেনু আইকন > আরও টুল > ডেভেলপার টুল বিকল্প বেছে নিন।
- JavaScript কনসোল খুলতে, আপনার কীবোর্ডে ESC কী টিপুন। ESC কী জাভাস্ক্রিপ্ট কনসোল টগল করবে। আপনি কনসোল বন্ধ করে দিলে, এটি আবার খুলতে ESC কী প্রেস করুন।
Maps JavaScript API লোড করার সময় কোনও সমস্যা বা সতর্কতা দেখা দিলে, সেগুলি কনসোলে এক বা একাধিক লাইন হিসেবে দেখা যায়। সমস্যা বা সতর্কতার মেসেজের ফর্ম্যাট নিচে দেওয়া হল:
Google Maps API error: [ERROR CODE] [Link to API document]
বা
Google Maps API warning: [ERROR CODE] [Link to API document]
সমস্যার মেসেজে সমস্যার কোড খুঁজে পেতে, উপরে দেওয়া সমস্যার কোড সারণী চেক করতে পারেন। এছাড়াও, আপনি মেসেজে লিঙ্ক করা API ডকুমেন্ট থেকে ত্রুটি মেসেজ সম্পর্কে বিস্তারিত তথ্য পেতে পারেন।
মনে রাখবেন: আপনি প্রোগ্রাম্যাটিক্যালি যাচাইকরণ সংক্রান্ত সমস্যার জন্য শুনতে পারবেন।
কাজ করে না এমন ব্রাউজার ম্যানেজ করা
আপনি যে ব্রাউজারের ভার্সন ব্যবহার করছেন সেটি Maps JavaScript API-এর সাথে বর্তমানে কাজ করে কিনা তা নিশ্চিত করুন।
আপনি যদি WebView-তে চলে এমন নেটিভ Windows অ্যাপ্লিকেশন ডেভেলপ করেন, তাহলে নিশ্চিত করুন যে আপনি Edge-এর উপর ভিত্তি করে WebView2 ব্যবহার করছেন। Internet Explorer-এর উপর ভিত্তি করে তৈরি WebView-এর আগের ভার্সন আর কাজ করে না।
এরপরেও কোড কাজ না করলে
আপনার ম্যাপ কোড চালু ও রানিং করতে সাহায্য করতে, Brendan Kenny এবং Mano Marks এই ভিডিওতে কিছু সাধারণ ভুল এবং কীভাবে সেগুলি ঠিক করতে হয় তা উল্লেখ করেছেন।
- বানান ভুল আছে কিনা তা দেখুন। মনে রাখবেন, JavaScript হল এমন একটি ভাষা যেখানে ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয়।
- প্রাথমিক বিষয়গুলি চেক করুন - ম্যাপ তৈরির প্রাথমিক পর্যায়ে কিছু সাধারণ সমস্যা
দেখা যায়। যেমন:
- আপনার ম্যাপ বিকল্পে
zoomএবংcenterপ্রপার্টি উল্লেখ করেছেন কিনা তা কনফার্ম করুন। - নিশ্চিত করুন যে আপনি একটি div এলিমেন্ট ঘোষণা করেছেন যাতে ম্যাপটি স্ক্রিনে দেখা যাবে।
- ম্যাপের জন্য div এলিমেন্টের উচ্চতা আছে কিনা তা নিশ্চিত করুন। ডিফল্ট হিসেবে, div এলিমেন্টগুলি ০ উচ্চতা সহ তৈরি করা হয় এবং সেই কারণে সেগুলি দেখা যায় না।
- আপনার ম্যাপ বিকল্পে
- সমস্যা শনাক্ত করতে জাভাস্ক্রিপ্ট ডিবাগার ব্যবহার করুন, যেমন Chrome ডেভেলপার টুল-এ উপলভ্য ডিবাগার। শুরু করতে, জাভাস্ক্রিপ্ট কনসোলে সমস্যা খুঁজুন।
- Stack Overflow-এ প্রশ্ন পোস্ট করুন। কীভাবে ভাল প্রশ্ন পোস্ট করতে হয় সেই সংক্রান্ত নির্দেশিকা সহায়তা পৃষ্ঠায় উপলভ্য।