সমস্যা ম্যানেজ করা

আপনি অনুরোধ করার পরে, এমন একটি উত্তর পেতে পারেন যাতে সমস্যার বিবরণ রয়েছে।

2D টাইল ও Street View ছবি

2D টাইলস ও Street View ছবি ব্যবহার করার সময় আপনি যেসব সমস্যার সম্মুখীন হতে পারেন, সেগুলি নিম্নলিখিত তালিকায় বিস্তারিতভাবে দেওয়া হল।

সমস্যার তালিকা

Map Tiles API ব্যবহার করার সময় আপনি যেসব সমস্যার সম্মুখীন হতে পারেন, নিম্নলিখিত তালিকায় তার বিবরণ দেওয়া হল।

required

আপনার অনুরোধে URL প্যারামিটার নেই। মনে রাখবেন, সমস্যার মেসেজে উল্লেখ করা থাকে কোন প্যারামিটারটি নেই।

notFound, invalid

আপনার x, y, অথবা z ভ্যালু রেঞ্জের বাইরে আছে।

• সাধারণ ম্যাপ টাইলের ক্ষেত্রে, সর্বাধিক জুম লেভেল নির্ভর করে নির্দিষ্ট ম্যাপ টাইল এবং আপনার অনুরোধ করা ম্যাপ বিকল্পের উপর।

• সাধারণ ম্যাপ টাইলসের জন্য, x স্থানাঙ্ক অবশ্যই [0, (2^zoom)-1] রেঞ্জের মধ্যে হতে হবে।

• সাধারণ ম্যাপ টাইলের জন্য, y কোঅর্ডিনেট অবশ্যই [0, (2^(zoom-1))-1] রেঞ্জের মধ্যে হতে হবে।

• Street View টাইলসের জন্য, জুম অবশ্যই শূন্য থেকে পাঁচের মধ্যে হতে হবে।

• Street View টাইলের ক্ষেত্রে, x এবং y কোঅর্ডিনেট রেঞ্জ, লেভেল পাঁচ জুম পর্যন্ত সাধারণ ম্যাপ টাইলের মতোই হয়। সেই সময়, সর্বাধিক মান হল imageHeight বা imagewidth, যা tileHeight বা tileWidth দিয়ে ভাগ করা হয়।

forbidden:

সম্ভাব্য কারণ:

• অনুরোধে সঠিক API key নেই।

• মেসেজ: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ইউরোপীয় অর্থনৈতিক অঞ্চলের (EEA) ঠিকানা সহ বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা প্রোজেক্টে 2D স্যাটেলাইট টাইল উপলভ্য নয়। আরও তথ্যের জন্য, ইউরোপীয় অর্থনৈতিক অঞ্চলের গ্রাহকদের জন্য Map Tiles API অ্যাডজাস্টমেন্ট দেখুন।

expired

আপনার session টোকেনের মেয়াদ শেষ হয়ে গেছে। সেশন টোকেন তৈরি করার সময় থেকে দুই সপ্তাহ পর্যন্ত বৈধ থাকে। মনে রাখবেন যে এটি কোনও বিজ্ঞপ্তি ছাড়াই পরিবর্তিত হতে পারে। আপনি এই সমস্যাটি দেখতে পেলে, আপনাকে অবশ্যই একটি নতুন সেশন টোকেন পেতে হবে, যেমনটি সেশন টোকেন ব্যবহার করুন-এ বর্ণনা করা হয়েছে।

badRequest

আপনার অনুরোধটি ভুল ছিল। সাধারণত এই কারণের জন্য:

• আপনি roadmap লেয়ার অন্তর্ভুক্ত না করেই terrain ম্যাপের ধরন উল্লেখ করেছেন।

• আপনি নন-রোডম্যাপ ম্যাপ টাইপের জন্য styles অ্যারে অন্তর্ভুক্ত করেছেন।

• আপনি Street View মেটাডেটা অনুরোধে অক্ষাংশ/দ্রাঘিমাংশ ভ্যালু এবং প্যানোরামা আইডি পাঠিয়েছেন।

quotaExceeded, rateLimitExceeded

আপনার অ্যাপ্লিকেশন অনুমোদিত কোটা অতিক্রম করেছে, অথবা এটি প্রতি সেকেন্ডে অনুমোদিত কোয়েরির সংখ্যা অতিক্রম করেছে।

সমস্যার উদাহরণ

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

অনুরোধ আবার চেষ্টা করা হচ্ছে

quotaExceeded এবং rateLimitExceeded-এর কারণে অনুরোধ ব্যর্থ হলে, আপনাকে এমনভাবে অনুরোধ আবার করার চেষ্টা করতে হবে যাতে অসম্পূর্ণ অনুরোধ বা বড় মাপের ব্যর্থতা Google সার্ভারকে ওভারলোড না করে—কারণ অনেক ক্লায়েন্ট দ্রুত একের পর এক অনুরোধ আবার করার চেষ্টা করে। এর অর্থ হল, আপনার অনুরোধ আবার করার সময় এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করা। এক্সপোনেনশিয়াল ব্যাকঅফ আপনাকে সময়ের সাথে সাথে অনুরোধগুলি ছড়িয়ে দিতে বাধ্য করে, যাতে সার্ভার রিকভার করার সময় পায়।

যেমন, কোনও অনুরোধ ব্যর্থ হলে, এক সেকেন্ড পরে আবার চেষ্টা করুন। কিন্তু সেই চেষ্টাও যদি ব্যর্থ হয়, তাহলে দুই সেকেন্ড পরে আবার অনুরোধ করুন। সেই অনুরোধও ব্যর্থ হলে, চার সেকেন্ড পরে আবার চেষ্টা করুন। তাই আপনি কার্যকরভাবে প্রতিটি পরবর্তী অনুরোধের মধ্যে সময়ের ব্যবধান দ্বিগুণ করে সেগুলি ছড়িয়ে দেন।

3D টাইল

Google-এর সার্ভার থেকে হওয়া সমস্যা আপনার কাছে স্পষ্ট নাও হতে পারে কারণ আপনি একটি রেন্ডারারের মাধ্যমে ফটোরিয়েলিস্টিক টাইল অ্যাক্সেস করেন, যা সার্ভারের সমস্যা ম্যানেজ করার জন্য দায়ী।

টাইল রেন্ডারার সংক্রান্ত সমস্যা

যেমন, সার্ভারে সমস্যা হলে CesiumJS রেন্ডারার সাধারণত কোনও বিজ্ঞপ্তি না দেখিয়েই কাজ করা বন্ধ করে দেয়, যার ফলে ক্র্যাশ, ফাঁকা স্ক্রিন থেকে শুরু করে নির্দিষ্ট টাইল লোড না হওয়ার মতো সমস্যা হতে পারে।

সার্ভারের সমস্যা ডিবাগ করার জন্য আপনি যে টেকনিক ব্যবহার করেন তা আপনার ব্যবহার করা নির্দিষ্ট রেন্ডারারের উপর নির্ভর করবে। CesiumJS-এর মতো ব্রাউজার-ভিত্তিক রেন্ডারারের জন্য, আপনি বেশিরভাগ ব্রাউজারে বিল্ট-ইন টুল দিয়ে নেটওয়ার্ক ট্রাফিক পরীক্ষা করতে পারেন। যেমন, আপনি Chrome DevTools ব্যবহার করতে পারেন।

যে ভুলগুলি প্রায়ই হয়ে থাকে

আপনি যেসব সাধারণ সমস্যার সম্মুখীন হতে পারেন সেগুলির বিবরণ নিম্নলিখিত তালিকায় দেওয়া হল।

৪০০: ভুল আর্গুমেন্ট

ভুল API কী, কোয়েরি প্যারামিটার, টাইল/টাইলসেট আইডি অথবা মেয়াদ শেষ হয়ে যাওয়া সেশন টোকেন।

৪০০: ভুল ভ্যালু

নিশ্চিত করুন যে mapType-এর সাথে createSessionToken অনুরোধ করা হয়েছে সেটি পরবর্তী টাইল এন্ডপয়েন্টে ব্যবহৃত mapType-এর সাথে মেলে। যেমন, streetview সেশন টোকেন ব্যবহার করে roadmap টাইল অনুরোধ করা যাবে না।

403: অনুমতি বাতিল করা হয়েছে

সম্ভাব্য কারণ:

• API key নেই, SSL কানেকশন নেই অথবা 3D টাইলসের জন্য আপনার API key অনুমোদিত তালিকায় যোগ করা হয়নি। Map Tiles API-এর 3D Tiles কার্যকারিতার জন্য অনুমোদিত তালিকায় যোগ করতে আপনার প্রোজেক্ট আইডি সহ Google সহায়তা টিমের সাথে যোগাযোগ করুন।

• মেসেজ: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

  ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ঠিকানার সাথে বিলিং অ্যাকাউন্টে লিঙ্ক করা প্রোজেক্টে ফটোরিয়ালস্টিক 3D টাইল উপলভ্য নয়। আরও তথ্যের জন্য, ইউরোপীয় অর্থনৈতিক অঞ্চলের গ্রাহকদের জন্য Map Tiles API অ্যাডজাস্টমেন্ট দেখুন।

৪২৯: অনেক বেশি অনুরোধ করা হয়েছে

আপনার কোটা শেষ হয়ে গেছে। আপনার কোটা বাড়াতে Google সহায়তা টিমের সাথে যোগাযোগ করুন।