Maps JavaScript API-এর মাধ্যমে যেসব সমস্যার মেসেজ দেখানো হতে পারে, এই পৃষ্ঠায় সেগুলি বর্ণনা করা হয়েছে। Maps JavaScript API, জাভাস্ক্রিপ্ট কনসোলে সমস্যা ও সতর্কতামূলক মেসেজ লিখে থাকে। এছাড়াও, কিছু নির্দিষ্ট সমস্যার কারণে ওয়াটারমার্ক সহ অন্ধকার ম্যাপ দেখানো হতে পারে।
API Key এবং বিলিং সংক্রান্ত সমস্যা
সমস্যার সমাধান
কিছু পরিস্থিতিতে, একটি অন্ধকার ম্যাপ বা 'নেগেটিভ' 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 পরিষেবার শর্তাবলী মেনে না চলার কারণে আপনার অ্যাপ্লিকেশন ব্লক করা হয়েছে, এই বিষয়ে আপনাকে একাধিক ইমেল বিজ্ঞপ্তি পাঠানো হয়েছে। ব্লক করার বিরুদ্ধে আপিল করতে এবং আপনার প্রয়োগ করা পদ্ধতি পর্যালোচনা করতে, 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 কনসোলে API কী দেখুন। আরও তথ্যের জন্য, API নিরাপত্তা সংক্রান্ত পেশাদার পদ্ধতি দেখুন। |
DeletedApiProjectMapError
|
সমস্যা |
আপনার API প্রোজেক্ট হয়ত Cloud কনসোল থেকে মুছে দেওয়া হয়েছে। যে প্রোজেক্টের জন্য আপনি API key তৈরি করেছেন সেটি চেক করুন, যেটি JavaScript API লোডারে অন্তর্ভুক্ত করা হয়েছে। আপনি নতুন API প্রোজেক্ট তৈরি করতে এবং Cloud কনসোলে নতুন কী পেতে পারেন। নতুন প্রোজেক্ট তৈরি করতে এবং প্রোজেক্টের জন্য API কী পেতে, নিচের বোতামে ক্লিক করুন।
|
ClientBillingNotEnabledMapError
|
সমস্যা |
আপনি নিজের প্রোজেক্টে বিলিং চালু করেননি। এই ক্লায়েন্ট আইডির সাথে যুক্ত Google Cloud প্রোজেক্টে আপনাকে অবশ্যই বিলিং চালু করতে হবে। |
BillingNotEnabledMapError
|
সমস্যা |
আপনি প্রোজেক্টে বিলিং চালু করেননি, তাই এই সমস্যা হচ্ছে। আপনাকে Google Cloud প্রোজেক্টে বিলিং চালু করতে হবে। |
ExpiredKeyMapError
|
সমস্যা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে অন্তর্ভুক্ত API কী-এর মেয়াদ শেষ হয়ে গেছে অথবা সিস্টেম সেটি শনাক্ত করতে পারছে না। নতুন API কী তৈরি করার পরে আপনি এই সমস্যা দেখতে পেতে পারেন, যদি আপনি সিস্টেমের দ্বারা শনাক্ত করার আগেই কী ব্যবহার করার চেষ্টা করেন। কয়েক মিনিট অপেক্ষা করে আবার চেষ্টা করুন অথবা আপনাকে Cloud কনসোলে নতুন API কী তৈরি করতে হতে পারে। API key পেতে, নিচের বোতামে ক্লিক করুন।
|
InvalidAppCheckTokenMapError
|
সমস্যা |
প্রদান করা App Check টোকেনটি ভুল বা এটির মেয়াদ শেষ হয়ে গেছে। App Check যাচাইকরণ ব্যবহার করা হলে তবেই এই সমস্যা হতে পারে। App Check যাচাইকরণ সংক্রান্ত নির্দেশিকা দেখুন। |
InvalidClientIdMapError
|
সমস্যা |
যাচাইকরণের নিরাপত্তা ও নির্ভরযোগ্যতা বাড়াতে, Maps Platform ক্লায়েন্ট আইডি ২৬ মে, ২০২৫ থেকে বন্ধ করে দেওয়া হয়েছে এবং ৩১ মে, ২০২৬-এর পর আর ব্যবহার করা যাবে না। ক্লায়েন্ট আইডি ব্যবহার করার পরিবর্তে, আপনার Google Maps API পরিষেবা ট্রাফিক যাচাই করতে আপনাকে অবশ্যই API Key ক্রেডেনশিয়াল ব্যবহার করতে হবে। আরও তথ্যের জন্য, ক্লায়েন্ট আইডি মাইগ্রেশন গাইড দেখুন। সাময়িকভাবে ক্লায়েন্ট আইডি ফিরিয়ে আনতে গাইডে উল্লেখ করা ধাপগুলি অনুসরণ করুন। |
InvalidKeyMapError
|
সমস্যা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে অন্তর্ভুক্ত API key খুঁজে পাওয়া যায়নি। আপনি সঠিক API key ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনি Cloud কনসোল থেকে নতুন API কী তৈরি করতে পারবেন। API key পেতে, নিচের বোতামে ক্লিক করুন।
|
MalformedCredentialsMapError
|
সমস্যা |
আপনার অ্যাপ্লিকেশন এমন URI স্কিম ব্যবহার করে যা কাজ করে না। অ্যাপ্লিকেশনটি RFC 3986-এ সংজ্ঞায়িত সঠিক URI ফর্ম্যাট ব্যবহার করছে কিনা তা যাচাই করুন। |
MissingKeyMapError
|
সমস্যা |
এপিআই লোড করে এমন স্ক্রিপ্ট এলিমেন্টে প্রয়োজনীয় যাচাইকরণ প্যারামিটার নেই। আপনি Maps JavaScript API ব্যবহার করলে, আপনাকে অবশ্যই সঠিক API key সহ
আপনি ক্লায়েন্ট আইডি ব্যবহার করলে, আপনাকে অবশ্যই
ক্লায়েন্ট আইডির সাথে আপনি যদি ওয়েবসাইটের মালিক না হন, তাহলে এই সমস্যা সমাধান করার জন্য আপনি কোনও পদক্ষেপ নিতে পারবেন না। তবে, সম্ভব হলে আপনি সাইটের মালিককে জানাতে চাইতে পারেন। |
ProjectDeniedMapError
|
সমস্যা |
আপনার অনুরোধ সম্পূর্ণ করা হয়নি। আপনি Cloud কনসোলে সমস্যা সম্পর্কে আরও বিবরণ পেতে পারেন। Cloud কনসোল দেখুন। |
RefererDeniedMapError
|
সমস্যা |
Google Maps Platform পরিষেবার শর্তাবলী মেনে না চলার কারণে আপনার অ্যাপ্লিকেশন ব্লক করা হয়েছে, এই বিষয়ে আপনাকে একাধিক ইমেল বিজ্ঞপ্তি পাঠানো হয়েছে। ব্লক করার বিরুদ্ধে আপিল করতে এবং আপনার প্রয়োগ করা পদ্ধতি পর্যালোচনা করতে, Google Maps Platform পরিষেবার শর্তাবলী আপিল ফর্ম পূরণ করুন। আপনি কয়েক কর্মদিবসের মধ্যে ইমেলের মাধ্যমে উত্তর পাবেন। |
RefererNotAllowedMapError
|
সমস্যা |
Maps JavaScript API লোড করা বর্তমান URL অনুমোদিত রেফারারের তালিকায় যোগ করা হয়নি। Cloud কনসোলে আপনার API কী-এর রেফারার সেটিংস চেক করুন। Maps JavaScript API দেখুন এবং API কী পান। |
OverQuotaMapError
|
সমস্যা |
অনুরোধের সংখ্যা Maps JavaScript API-এর ব্যবহারের সীমা ছাড়িয়ে গেছে। পরের দৈনিক কোটা রিসেট করার সময় আপনার অ্যাপের অনুরোধ আবার কাজ করবে। আপনি যদি ওয়েবসাইটের মালিক না হন, তাহলে এই সমস্যা সমাধান করার জন্য আপনি কোনও পদক্ষেপ নিতে পারবেন না। তবে, সম্ভব হলে আপনি সাইটের মালিককে জানাতে পারেন। আরও জানতে, ব্যবহারের সীমা সংক্রান্ত নির্দেশিকা দেখুন। এছাড়াও, কীভাবে আপনি ব্যবহারের সীমা আরও বাড়াতে পারবেন তা এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে। |
ApiProjectMapError
|
সমস্যা |
প্রদান করা API key অথবা যে API প্রোজেক্টের সাথে এটি যুক্ত আছে, তার কোনওটিই সমাধান করা যায়নি। এই সমস্যাটি সাময়িক হতে পারে। এই সমস্যার মেসেজ দেখানো বন্ধ না হলে, আপনাকে নতুন API কী পেতে বা নতুন API প্রোজেক্ট তৈরি করতে হতে পারে। আরও তথ্যের জন্য, Google Maps Platform ব্যবহার শুরু করুন দেখুন। |
ClientIdLooksLikeCryptoKey
|
সতর্কতা |
আপনি হয়ত ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
ClientIdLooksLikeKey
|
সতর্কতা |
আপনি হয়ত API কী ও ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
InvalidChannel
|
সতর্কতা |
আপনি হয়ত ভুল |
InvalidClientId
|
সতর্কতা |
API কী ও ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
InvalidKey
|
সতর্কতা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে অন্তর্ভুক্ত API key সঠিক বলে মনে হচ্ছে না। আপনি সঠিক API key ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনি Cloud কনসোলে নতুন API কী তৈরি করতে পারবেন। API key পেতে, নিচের বোতামে ক্লিক করুন।
|
InvalidVersion
|
সতর্কতা |
আপনি হয়ত স্ক্রিপ্ট এলিমেন্টে ভুল ভার্সন নম্বর দিয়েছেন। আপনি সঠিক ভার্সন নম্বর ব্যবহার করছেন কিনা তা ভালোভাবে দেখে নিন। |
KeyLooksLikeClientId
|
সতর্কতা |
আপনি হয়ত API কী ও ক্লায়েন্ট আইডি সম্পর্কিত নির্দেশিকা দেখুন। |
KeyLooksLikeCryptoKey
|
সতর্কতা |
আপনি হয়ত API লোড করার সময় ক্লায়েন্ট আইডি নির্দিষ্ট করা সম্পর্কিত নির্দেশিকা দেখুন। |
KeyLooksLikeProjectNumber
|
সতর্কতা |
আপনি হয়ত API কী কীভাবে পাবেন তা জানুন। |
NoApiKeys
|
সতর্কতা |
API লোড করে এমন স্ক্রিপ্ট এলিমেন্টে কোনও API key নেই। আপনি
API key পেতে, শুরু করার জন্য নিচের বোতামে ক্লিক করুন।
আপনি যদি বন্ধ হয়ে যাওয়া 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-এ, আপনি
জাভাস্ক্রিপ্ট কনসোল
ব্যবহার করে নিম্নলিখিত উপায়ে window.console আউটপুট চেক করতে পারবেন।
- ডেভেলপার টুল খুলতে, মেনু আইকন > আরও টুল > ডেভেলপার টুল বিকল্প বেছে নিন।
- জাভাস্ক্রিপ্ট কনসোল খুলতে, আপনার কীবোর্ডে 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-এর আগের ভার্সন আর কাজ করে না।
আপনার কোড এখনও কাজ না করলে
আপনার ম্যাপ কোড চালু করতে সাহায্য করার জন্য, ব্রেন্ডন কেনি এবং মানো মার্কস কিছু সাধারণ ভুল এবং এই ভিডিওতে সেগুলি কীভাবে ঠিক করা যায় তা উল্লেখ করেছেন।
- বানান ভুল আছে কিনা তা দেখুন। মনে রাখবেন, JavaScript-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয়।
- প্রাথমিক বিষয়গুলি চেক করুন - ম্যাপ তৈরির প্রাথমিক পর্যায়ে কিছু সাধারণ সমস্যা
দেখা যায়। যেমন:
- আপনার ম্যাপ বিকল্পে
zoomএবংcenterপ্রপার্টি উল্লেখ করেছেন কিনা তা কনফার্ম করুন। - নিশ্চিত করুন যে আপনি একটি div এলিমেন্ট ঘোষণা করেছেন যেখানে ম্যাপটি স্ক্রিনে প্রদর্শিত হবে।
- ম্যাপের জন্য div এলিমেন্টের উচ্চতা আছে কিনা তা নিশ্চিত করুন। ডিফল্ট হিসেবে, div এলিমেন্ট 0 উচ্চতা নিয়ে তৈরি হয় এবং তাই দেখা যায় না।
- আপনার ম্যাপ বিকল্পে
- সমস্যা শনাক্ত করতে জাভাস্ক্রিপ্ট ডিবাগার ব্যবহার করুন, যেমন Chrome ডেভেলপার টুলে উপলভ্য ডিবাগার। শুরুতে, জাভাস্ক্রিপ্ট কনসোলে কোনও সমস্যা আছে কিনা তা দেখুন।
- Stack Overflow-এ প্রশ্ন পোস্ট করুন। কীভাবে দারুণ প্রশ্ন পোস্ট করতে হয় সেই সংক্রান্ত নির্দেশিকা সহায়তা পৃষ্ঠায় উপলভ্য আছে।