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

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

2D টাইলস এবং রাস্তার দৃশ্যের চিত্রাবলী

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 :

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

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

• বার্তা: 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 ব্যবহার করে অনুরোধগুলি ব্যর্থ হয়, তখন আপনার অনুরোধটি পুনরায় চেষ্টা করা উচিত যাতে ভাঙা অনুরোধ বা বিস্তৃত ব্যর্থতা Goodle সার্ভারগুলিতে না আসে—কারণ অনেক ক্লায়েন্ট দ্রুত ধারাবাহিকভাবে অনুরোধগুলি পুনরায় চেষ্টা করার চেষ্টা করে। এর অর্থ হল আপনার অনুরোধগুলি পুনরায় চেষ্টা করার সময় exponential backoff ব্যবহার করা। Exponential backoff আপনাকে আপনার অনুরোধগুলিকে সময়মতো ছড়িয়ে দিতে বাধ্য করে, যাতে সার্ভারটি পুনরুদ্ধারের জন্য সময় পায়।

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

3D টাইলস

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

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

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

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

সাধারণ ত্রুটি

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

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

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

৪০০: অবৈধ মান

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

৪০৩: অনুমতি প্রত্যাখ্যান

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

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

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

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

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

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