হ্যান্ডলিং ত্রুটি

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

2D টাইলস এবং স্ট্রিট ভিউ চিত্রাবলী

২ডি টাইলস এবং স্ট্রিট ভিউ চিত্র ব্যবহার করার সময় আপনি যে ত্রুটিগুলির সম্মুখীন হতে পারেন, নিম্নলিখিত তালিকায় তার বিবরণ দেওয়া হলো।

ত্রুটি তালিকাভুক্তকরণ

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

required

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

notFound , invalid

আপনার x , y , বা z মানগুলো সীমার বাইরে রয়েছে।

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

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

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

• স্ট্রিট ভিউ টাইলসের জন্য, জুম অবশ্যই শূন্য থেকে পাঁচের মধ্যে হতে হবে (উভয় মান সহ)।

• লেভেল পাঁচ জুম পর্যন্ত, স্ট্রিট ভিউ টাইলগুলির জন্য x এবং y স্থানাঙ্কের পরিসীমা সাধারণ ম্যাপ টাইলগুলির মতোই থাকে। সেই পর্যায়ে, সর্বোচ্চ মান হয় imageHeight বা imagewidth tileHeight বা tileWidth দ্বারা ভাগ করার সমান।

forbidden :

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

• অনুরোধটিতে একটি বৈধ এপিআই কী নেই।

• বার্তা: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

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

expired

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

badRequest

আপনার অনুরোধটি ত্রুটিপূর্ণ ছিল। এর সাধারণ কারণগুলোর মধ্যে রয়েছে:

• আপনি roadmap লেয়ার অন্তর্ভুক্ত না করেই একটি terrain ম্যাপ টাইপ নির্দিষ্ট করেছেন।

• আপনি রোডম্যাপ নয় এমন একটি মানচিত্রের ধরনের জন্য একটি styles অ্যারে অন্তর্ভুক্ত করেছেন।

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

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 টাইলস

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

টাইল রেন্ডারার ত্রুটি

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

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

সাধারণ ভুল

নিম্নলিখিত তালিকায় সবচেয়ে সাধারণ ত্রুটিগুলো সম্পর্কে বিস্তারিত তথ্য রয়েছে, যেগুলোর সম্মুখীন আপনি হতে পারেন।

৪০০: অবৈধ যুক্তি

অবৈধ এপিআই কী, কোয়েরি প্যারামিটার, টাইল/টাইলসেট আইডি, অথবা মেয়াদোত্তীর্ণ সেশন টোকেন।

৪০০: অবৈধ মান

নিশ্চিত করুন যে, যে mapType ব্যবহার করে createSessionToken অনুরোধটি করা হয়েছিল, তা পরবর্তী tile endpoint-এ ব্যবহৃত mapType সাথে মেলে। উদাহরণস্বরূপ, একটি streetview সেশন টোকেন ব্যবহার করে roadmap tile-এর জন্য অনুরোধ করা যাবে না।

৪০৩: অনুমতি নেই

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

• এপিআই কী অনুপস্থিত, এসএসএল সংযোগ নেই, অথবা আপনার এপিআই কী 3D টাইলসের জন্য অনুমোদিত তালিকায় (allowlist) যোগ করা হয়নি। ম্যাপ টাইলস এপিআই-এর 3D টাইলস কার্যকারিতার জন্য অনুমোদিত তালিকায় যুক্ত হতে আপনার প্রজেক্ট আইডি সহ গুগল সাপোর্টের সাথে যোগাযোগ করুন।

• বার্তা: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

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

৪২৯: অনেক বেশি অনুরোধ

আপনার কোটা শেষ হয়ে গেছে। কোটা বাড়ানোর জন্য গুগল সাপোর্টে যোগাযোগ করুন।