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

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

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

2D টাইলস এবং রাস্তার দৃশ্য চিত্র ব্যবহার করার সময় আপনি যে ত্রুটির সম্মুখীন হতে পারেন সেগুলির বিবরণ নিম্নলিখিত তালিকায় রয়েছে৷

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

নিম্নলিখিত তালিকাটি ম্যাপ টাইলস API ব্যবহার করার সময় আপনি যে ত্রুটিগুলির সম্মুখীন হতে পারেন তার বিবরণ দেয়৷

required
আপনার অনুরোধ একটি URL প্যারামিটার অনুপস্থিত. মনে রাখবেন যে ত্রুটি বার্তাটি নির্দেশ করে যে কোন প্যারামিটারটি অনুপস্থিত।
notFound , invalid

আপনার x , y , বা z মান পরিসীমার বাইরে।

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

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

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

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

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

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

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

আপনার অনুরোধ বিকৃত ছিল. এই জন্য সাধারণ কারণ অন্তর্ভুক্ত:

  • আপনি একটি roadmap স্তর অন্তর্ভুক্ত না করে একটি terrain মানচিত্রের ধরন নির্দিষ্ট করেছেন৷

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

  • আপনি রাস্তার দৃশ্যের মেটাডেটা অনুরোধে একটি ল্যাট/lng মান, সেইসাথে একটি প্যানোরামা আইডি পাঠিয়েছেন।

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

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

3D টাইলস

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

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

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

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

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

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

400: অবৈধ যুক্তি
অবৈধ API কী, ক্যোয়ারী প্যারামিটার, টাইল/টাইলসেট আইডি, বা মেয়াদ শেষ হওয়া সেশন টোকেন।
403: অনুমতি অস্বীকার করা হয়েছে
অনুপস্থিত API কী, অনুপস্থিত SSL সংযোগ, বা আপনার API কী 3D টাইলের জন্য অনুমোদিত তালিকায় যোগ করা হয়নি। Map Tiles API-এর 3D টাইলস কার্যকারিতার জন্য অনুমোদিত তালিকায় যোগ করতে আপনার প্রোজেক্ট আইডি সহ Google সহায়তার সাথে যোগাযোগ করুন।
429: অনেক বেশি অনুরোধ
আপনার কোটা শেষ হয়ে গেছে। আপনার কোটা বাড়াতে Google সহায়তার সাথে যোগাযোগ করুন।